NTMS_OPREQUESTINFORMATIONA structure (ntmsapi.h)

  • Article

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

La structure NTMS_OPREQUESTINFORMATION définit les propriétés spécifiques au contrôle système opérateur-demande pour RSM.

Syntaxe

typedef struct _NTMS_OPREQUESTINFORMATIONA {
  DWORD      Request;
  SYSTEMTIME Submitted;
  DWORD      State;
  CHAR       szMessage[NTMS_MESSAGE_LENGTH];
  DWORD      Arg1Type;
  NTMS_GUID  Arg1;
  DWORD      Arg2Type;
  NTMS_GUID  Arg2;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
} NTMS_OPREQUESTINFORMATIONA;

Membres

Request

Type de demande d’opérateur. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
NTMS_OPREQ_NEWMEDIA
 Une application qui tente d’allouer un média envoie une demande d’opérateur pour un nouveau média lorsqu’aucun média n’est disponible. Lorsque cet indicateur est défini, le membre Arg1 doit être défini sur le GUID du pool de supports nécessitant un nouveau média. Si vous le souhaitez, le membre Arg2 peut être défini sur la bibliothèque particulière dans laquelle le nouveau média doit être placé.
NTMS_OPREQ_CLEANER
 RSM envoie une demande d’opérateur pour un nettoyeur lorsqu’une opération de propre est mise en file d’attente et qu’aucun nettoyeur n’est en ligne et disponible sur le lecteur. Lorsque cet indicateur est défini, le membre Arg1 doit être défini sur le GUID de la bibliothèque nécessitant la cartouche de nettoyage.
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. Lorsque cet indicateur est défini, le membre Arg1 doit être défini sur le GUID de l’appareil nécessitant un service.
NTMS_OPREQ_MOVEMEDIA
 Une application ou RSM envoie une demande d’opérateur pour déplacer le support spécifié pour traiter un montage pour un média hors connexion ou pour éjecter un média vers une bibliothèque hors connexion. Lorsque cet indicateur est défini, le membre Arg1 doit être défini sur le GUID du média physique à déplacer et le membre Arg2 doit être défini sur le GUID de la bibliothèque vers laquelle ce média doit être déplacé.
NTMS_OPREQ_MESSAGE
 Demande d’opérateur spécifique à l’application. Texte uniquement.

Submitted

Heure système à laquelle la demande d’opérateur a été envoyée.

State

État actuel de la demande de service de l’opérateur. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
NTMS_OPSTATE_SUBMITTED
 La demande d’opérateur a été envoyée, mais pas lue par une console opérateur.
NTMS_OPSTATE_ACTIVE
 La demande d’opérateur a été lue par une ou plusieurs consoles opérateur et peut être en cours.
NTMS_OPSTATE_INPROGRESS
 L’utilisateur a reconnu cette demande d’opérateur et est en cours d’exécution du service.
NTMS_OPSTATE_REFUSED
 L’utilisateur a rejeté la demande de service de l’opérateur.
NTMS_OPSTATE_COMPLETE
 L’utilisateur a terminé la demande de service de l’opérateur.

szMessage[NTMS_MESSAGE_LENGTH]

Texte du message de l’opérateur.

Arg1Type

Type de l’objet Arg1 . Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
NTMS_UNKNOWN
 Aucun objet fourni dans Arg1Type.
NTMS_CHANGER
 Objet de changeur moyen.
NTMS_DRIVE
 Objet Drive.
NTMS_IEDOOR
 Objet de porte de bibliothèque.
NTMS_IEPORT.
 Objet de port d’insertion/d’éjection de bibliothèque
NTMS_LIBRARY
 Objet library.
NTMS_PARTITION
 Objet latéral.
NTMS_PHYSICAL_MEDIA
 Objet multimédia physique.
NTMS_STORAGESLOT
 Objet d’emplacement de bibliothèque.

Arg1

ID d’objet Arg1 utilisé pour les demandes de déplacement ou d’autres demandes d’opérateur qui nécessitent un objet de référence. L’objectif de cet objet varie en fonction du type de demande d’opérateur. Pour les utilisations appropriées d’Arg1, consultez la description de la demande .

Arg2Type

Type d’objet Arg2 . Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
NTMS_UNKNOWN
 Aucun objet fourni dans Arg2Type.
NTMS_LIBRARY
 Objet library.

Arg2

ID d’objet Arg2 utilisé pour les demandes d’opérateur qui nécessitent un deuxième objet de référence. L’objectif de cet objet varie en fonction du type de demande d’opérateur. Pour les utilisations appropriées d’Arg2, consultez la description de la demande .

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Application qui a envoyé la demande d’opérateur.

szUser[NTMS_USERNAME_LENGTH]

L’utilisateur interactif s’est connecté à l’ordinateur qui a envoyé la demande d’opérateur.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Ordinateur qui a envoyé la demande d’opérateur.

Remarques

La structure NTMS_OPREQUESTINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION .

Notes

L’en-tête ntmsapi.h définit NTMS_OPREQUESTINFORMATION en tant qu’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. La combinaison 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]
En-tête ntmsapi.h

Voir aussi

NTMS_OBJECTINFORMATION