Funzione GetNtmsRequestOrder (ntmsapi.h)

Articolo
02/29/2024

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

La funzione GetNtmsRequestOrder ottiene l'ordine di elaborazione della richiesta specificata nella coda della libreria.

Sintassi

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpRequestId

Identificatore univoco di una richiesta di libreria.

[out] lpdwOrderNumber

Ordine in cui questa 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 anche possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: Non sono necessari diritti di accesso.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER	L'identificatore della richiesta di libreria non è presente.
ERROR_OBJECT_NOT_FOUND	Impossibile trovare un oggetto request con l'identificatore specificato.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

Se la funzione GetNtmsRequestOrder restituisce zero in lpdwOrderNumber, l'ordinamento non è disponibile per questa richiesta. Il numero di ordine è specifico del tipo di richiesta perché i tipi vengono elaborati in un ordine predeterminato.

Ad esempio, la richiesta di NTMS_LM_DISMOUNT viene elaborata prima di una richiesta di NTMS_LM_MOUNT. All'interno di una classe specifica di richieste la coda può tuttavia essere ordinata. Le richieste ordinate più basse vengono elaborate prima, ad esempio 1 è la prima richiesta elaborata, 2 è la successiva richiesta elaborata e così via.

È possibile usare questo numero di ordine, il tipo di richiesta, l'ora di invio e la data di invio per visualizzare la coda nell'ordine ordinato. Il tipo di richiesta, il numero di ordine e l'ora di invio devono eseguire l'ordinamento.

Attualmente in NTMS_LM_MOUNT, le richieste vengono ordinate usando il numero di ordine.

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

Funzioni di controllo della libreria

SetNtmsRequestOrder

Condividi tramite