SubmitNtmsOperatorRequestW, fonction (ntmsapi.h)

Article
11/20/2024

[Gestionnaire de stockage amovible n’est plus disponible depuis 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 être l’une des valeurs suivantes.

Valeur	Signification
NTMS_OPREQ_CLEANER	RSM envoie une demande d’opérateur pour insérer un nettoyeur lorsqu’une opération de nettoyage est mise en file d’attente et qu’aucun nettoyage 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 un RSM envoie une demande d’opérateur pour le service de lecteur lorsqu’un appareil ou un lecteur changeur rencontre des problèmes. Le paramètre lpArg1Id spécifie l’appareil qui a besoin du service. Ce paramètre peut être une porte dérobée, 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 un 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 l’élément de support 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 supports. Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQ_NEWMEDIA	Une application ou un 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 de pool de supports 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 supports. 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 du paramètre dwRequest pour obtenir une description du type d’objet à passer pour ce paramètre.

[in] lpArg2Id

Identificateur d’objet pour la demande d’opérateur. Reportez-vous aux descriptions des valeurs du paramètre dwRequest pour plus d’informations sur le type d’objet à transmettre pour ce paramètre.

[out] lpRequestId

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

Valeur de retour

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 de base de données ou de la mise à jour.
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 l’état 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 support, pour demander que le support spécifié soit déplacé d’une bibliothèque vers une autre ou pour demander le 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êtes en fonction des besoins.

Note

L’en-tête ntmsapi.h définit SubmitNtmsOperatorRequest comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	ntmsapi.h
bibliothèque	Ntmsapi.lib
DLL	Ntmsapi.dll