Fonction SubmitNtmsOperatorRequestW (ntmsapi.h)

Article
08/25/2023

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

La fonction SubmitNtmsOperatorRequest envoie une demande d’opérateur RSM.

Syntaxe

DWORD SubmitNtmsOperatorRequestW(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCWSTR     lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession .

[in] dwRequest

Type de demande d’opérateur. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
NTMS_OPREQ_CLEANER	RSM envoie une demande d’opérateur pour insérer un nettoyeur lorsqu’une opération de propre est mise en file d’attente et qu’aucun nettoyeur n’est disponible pour le lecteur. Le paramètre lpArg1Id peut être un identificateur de bibliothèque ou d’emplacement. Nécessite NTMS_CONTROL_ACCESS à la bibliothèque. Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQ_DEVICESERVICE	Une application ou RSM envoie une demande d’opérateur pour le service de lecteur lorsqu’un périphérique de changeur ou un lecteur rencontre des problèmes. Le paramètre lpArg1Id spécifie l’appareil qui a besoin d’un service. Ce paramètre peut être un iedoor, une bibliothèque, un média physique ou un identificateur de lecteur. Nécessite NTMS_CONTROL_ACCESS à la bibliothèque. Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQ_MESSAGE	Message d’application uniquement. Nécessite NTMS_USE_ACCESS à l’ordinateur. Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQ_MOVEMEDIA	Une application ou RSM envoie une demande d’opérateur pour déplacer un média d’une bibliothèque vers une autre pour un montage de média hors connexion ou pour éjecter un média existant vers la bibliothèque hors connexion. Le paramètre lpArg1Id spécifie le morceau de média physique qui doit être déplacé et le paramètre lpArg2Id spécifie la bibliothèque cible. Nécessite NTMS_CONTROL_ACCESS au pool de médias. Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQ_NEWMEDIA	Une application ou RSM envoie une demande d’opérateur pour un nouveau média lorsqu’aucun média n’est disponible. Le paramètre lpArg1Id spécifie l’objet du pool de médias et le paramètre lpArg2Id est l’identificateur de bibliothèque facultatif auquel ajouter le nouveau support. Nécessite NTMS_CONTROL_ACCESS au pool de médias. Windows XP : Aucun droit d’accès n’est requis.

[in] lpMessage

Chaîne de message facultative à envoyer à l’utilisateur.

[in] lpArg1Id

Identificateur d’objet pour la demande d’opérateur. Reportez-vous aux descriptions des valeurs dans le paramètre dwRequest pour obtenir une description du type d’objet qui doit être passé pour ce paramètre.

[in] lpArg2Id

Identificateur d’objet pour la demande d’opérateur. Reportez-vous aux descriptions des valeurs dans le paramètre dwRequest pour plus d’informations sur le type d’objet qui doit être passé pour ce paramètre.

[out] lpRequestId

Pointeur vers une mémoire tampon qui reçoit l’identificateur de la demande d’opérateur qui a été créée.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’accès à un ou plusieurs objets RSM est refusé.
ERROR_DATABASE_FAILURE	Échec de la requête ou de la mise à jour de la base de données.
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 source ou de destination.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La fonction SubmitNtmsOperatorRequest envoie une demande d’opérateur et retourne le status de la demande (satisfait ou annulé) ou expire (si l’opérateur n’agit pas sur la demande). Les demandes d’opérateur sont utilisées pour demander un média, pour demander que le support spécifié soit déplacé d’une bibliothèque à une autre ou pour demander un service d’appareil RSM.

La valeur NTMS_OPEREQ_MESSAGE (dans le paramètre dwRequest ) est le type de requête le plus souvent utilisé par les applications. RSM ne peut pas utiliser NTMS_OPEREQ_MESSAGE. RSM utilise les autres types de requête en fonction des besoins.

Notes

L’en-tête ntmsapi.h définit SubmitNtmsOperatorRequest comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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