Fonction SubmitNtmsOperatorRequestA (ntmsapi.h)
[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 SubmitNtmsOperatorRequestA(
[in] HANDLE hSession,
[in] DWORD dwRequest,
[in] LPCSTR 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.
[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 |
---|---|
|
L’accès à un ou plusieurs objets RSM est refusé. |
|
Échec de la requête ou de la mise à jour de la base de données. |
|
La valeur spécifiée dans le paramètre hSession est NULL ou n’est pas valide. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
Impossible de se connecter au service RSM. |
|
Impossible de trouver l’objet source ou de destination. |
|
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 |