Funzione SetNtmsRequestOrder (ntmsapi.h)

Articolo
02/29/2024

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione SetNtmsRequestOrder imposta l'ordine di elaborazione della richiesta specificata nella coda di libreria.

Sintassi

DWORD SetNtmsRequestOrder(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwOrderNumber
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpRequestId

Identificatore univoco di una richiesta di libreria.

[in] dwOrderNumber

Ordine in cui la richiesta verrà elaborata nella coda.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS al computer viene negato. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: Non sono necessari diritti di accesso.
ERROR_DATABASE_FAILURE	Il database non è accessibile o danneggiato.
ERROR_INVALID_HANDLE	L'handle di sessione è mancante o non è valido.
ERROR_INVALID_PARAMETER	Identificatore della richiesta di libreria mancante.
ERROR_OBJECT_NOT_FOUND	Impossibile trovare un oggetto richiesta con l'identificatore specificato.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

Attualmente NTMS_LM_MOUNT richieste vengono ordinate usando il numero di ordine.

Il numero di ordine impostato dalla funzione SetNtmsRequestOrder è specifico del tipo di richiesta perché i tipi vengono elaborati in un ordine predeterminato. Ad esempio, una richiesta di NTMS_LM_DISMOUNT viene elaborata prima di una richiesta di NTMS_LM_MOUNT. All'interno di una classe specifica di richieste è tuttavia possibile ordinare la coda. Le richieste ordinate inferiori vengono elaborate per prime; Ad esempio, 1 è la prima richiesta elaborata, 2 è la richiesta successiva elaborata e così via.

Per elaborare immediatamente una richiesta, un'applicazione può impostare il numero di ordine su 1. Per rinviare l'elaborazione, un'applicazione deve impostare il numero di ordine su un numero molto grande o 0xFFFFFFFF. Non è possibile modificare il numero di ordine di una richiesta, che attualmente ha un numero di ordine pari a zero.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll

Vedi anche

GetNtmsRequestOrder

Funzioni di controllo della libreria

Condividi tramite