SubmitNtmsOperatorRequestW, fonction (ntmsapi.h)
[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.
DWORD SubmitNtmsOperatorRequestW(
[in] HANDLE hSession,
[in] DWORD dwRequest,
[in] LPCWSTR lpMessage,
[in] LPNTMS_GUID lpArg1Id,
[in] LPNTMS_GUID lpArg2Id,
[out] LPNTMS_GUID lpRequestId
);
[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.
[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.
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 de base de données ou de la mise à jour. |
|
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. |
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.
Notes
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.
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 |