Fonction WaitForNtmsOperatorRequest (ntmsapi.h)

Article
03/04/2024

[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

Partager via