Fonction WaitForNtmsOperatorRequest (ntmsapi.h)

  • Article

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction WaitForNtmsOperatorRequest attend la demande d’opérateur RSM spécifiée.

Syntaxe

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

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpRequestId

Identificateur de demande d’opérateur créé par la fonction SubmitNtmsOperatorRequest .

[in] dwTimeout

Nombre de millisecondes à attendre. Pour case activée pour une demande d’opérateur, transmettez une valeur de délai d’attente de zéro. Si vous spécifiez la valeur INFINITE, cette fonction n’expire pas.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_CANCELLED
 La demande de l’opérateur a été annulée par un administrateur.
ERROR_INVALID_HANDLE
 La valeur spécifiée dans le paramètre hSession est NULL ou n’est pas valide.
ERROR_INVALID_PARAMETER
 L’une des valeurs de paramètre n’est pas valide.
ERROR_NOT_CONNECTED
 Impossible de se connecter au service RSM.
ERROR_OBJECT_NOT_FOUND
 Impossible de trouver l’objet de demande d’opérateur. Les demandes d’objet sont vidées de la base de données. L’application doit appeler une fonction telle que AllocateNtmsMedia si RSM retourne cette erreur.
ERROR_SUCCESS
 La fonction a réussi.
ERROR_TIMEOUT
 Le temps spécifié dans le paramètre dwTimeout s’est écoulé avant l’achèvement de la demande de l’opérateur.

Remarques

Les demandes d’opérateur spécifiées avec la fonction WaitForNtmsOperatorRequest sont utilisées pour demander le support, pour demander que le support soit déplacé d’une bibliothèque à une autre ou pour demander le service d’appareil RSM.

Une application utilise WaitForNtmsOperatorRequest pour attendre la résolution d’une demande d’opérateur. La demande peut être satisfaite, rejetée, supprimée ou expirée.

En règle générale, les applications utilisent la fonction SubmitNtmsOperatorRequest pour envoyer des demandes d’opérateur et utilisent la fonction WaitForNtmsOperatorRequest pour attendre leur résolution.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntmsapi.h
Bibliothèque Ntmsapi.lib
DLL Ntmsapi.dll

Voir aussi

CancelNtmsOperatorRequest

Fonctions de demande d’opérateur

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest