Funzione WaitForNtmsOperatorRequest (ntmsapi.h)

Articolo
08/25/2023

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

La funzione WaitForNtmsOperatorRequest attende la richiesta dell'operatore RSM specificata.

Sintassi

DWORD WaitForNtmsOperatorRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwTimeout
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpRequestId

Identificatore della richiesta dell'operatore creato dalla funzione SubmitNtmsOperatorRequest .

[in] dwTimeout

Numero di millisecondi di attesa. Per verificare la presenza di una richiesta di operatore, passare un valore di timeout pari a zero. Se si specifica un valore INFINITE, questa funzione non si verifica il timeout.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_CANCELLED	La richiesta dell'operatore è stata annullata da un amministratore.
ERROR_INVALID_HANDLE	Il valore specificato nel parametro hSession è NULL o non è valido.
ERROR_INVALID_PARAMETER	Uno dei valori dei parametri non è valido.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_OBJECT_NOT_FOUND	Impossibile trovare l'oggetto richiesta dell'operatore. Le richieste di oggetti vengono scaricate dal database. L'applicazione deve chiamare una funzione come AllocateNtmsMedia se RSM restituisce questo errore.
ERROR_SUCCESS	La funzione ha avuto esito positivo.
ERROR_TIMEOUT	Tempo specificato nel parametro dwTimeout trascorso prima del completamento della richiesta dell'operatore.

Commenti

Le richieste di operatore specificate con la funzione WaitForNtmsOperatorRequest vengono usate per richiedere supporto, per richiedere che il supporto venga spostato da una libreria a un'altra o per richiedere il servizio dispositivo RSM.

Un'applicazione usa WaitForNtmsOperatorRequest per attendere la risoluzione di una richiesta di operatore. La richiesta può essere soddisfatta, rifiutata, eliminata o timeout.

In genere, le applicazioni usano la funzione SubmitNtmsOperatorRequest per inviare richieste di operatore e usare la funzione WaitForNtmsOperatorRequest per attendere la risoluzione.

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

CancelNtmsOperatorRequest

Funzioni di richiesta dell'operatore

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest

Condividi tramite