structure NTMS_LIBREQUESTINFORMATIONA (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 structure NTMS_LIBREQUESTINFORMATION définit les propriétés propres à une demande de travail, qui sont mises en file d’attente vers RSM.

Syntaxe

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

Membres

OperationCode

Opération d’élément. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_LM_CLASSIFY	Classifiez le support.
NTMS_LM_CLEANDRIVE	Nettoyer un lecteur.
NTMS_LM_DISABLELIBRARY	Désactivez le changeur.
NTMS_LM_DISABLEDRIVE	Désactiver un lecteur.
NTMS_LM_DISABLEMEDIA	Désactivez le support.
NTMS_LM_DISMOUNT	Démonter le support d’un lecteur.
NTMS_LM_DOORACCESS	Autoriser l’accès aux médias via une porte d’unité de bibliothèque.
NTMS_LM_EJECT	Éjectez le support de la bibliothèque.
NTMS_LM_EJECTCLEANER	Éjectez un nettoyeur.
NTMS_LM_ENABLELIBRARY	Activez le changeur.
NTMS_LM_ENABLEDRIVE	Activer un lecteur.
NTMS_LM_ENABLEMEDIA	Activez le support.
NTMS_LM_INJECT	Insérez le support dans la bibliothèque.
NTMS_LM_INJECTCLEANER	Insérez un nettoyeur.
NTMS_LM_INVENTORY	Effectuez un inventaire de la bibliothèque.
NTMS_LM_MOUNT	Montez un côté sur un lecteur.
NTMS_LM_PROCESSOMID	Traitez l’OMID.
NTMS_LM_RELEASECLEANER	Relâchez un emplacement plus propre.
NTMS_LM_REMOVE	Supprimez un élément de travail de la file d’attente.
NTMS_LM_RESERVECLEANER	Réserver un emplacement plus propre.
NTMS_LM_UPDATEOMID	Mettez à jour l’OMID.
NTMS_LM_WRITESCRATCH	Écrivez une étiquette gratuite.

OperationOption

Options d’élément de travail (spécifiques à la commande).

State

État actuel de cet élément de travail. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_LM_QUEUED	L’opération est mise en file d’attente.
NTMS_LM_INPROCESS	L’opération est en cours de traitement.
NTMS_LM_PASSED	Opération exécutée avec succès.
NTMS_LM_FAILED	L’opération s’est terminée avec une erreur.
NTMS_LM_WAITING	L’opération est bloquée.
NTMS_LM_CANCELLED	L’opération a été annulée.
NTMS_LM_INVALID	L’opération n’est pas valide.

PartitionId

Identificateur unique d’un côté en cours de maintenance.

DriveId

Identificateur unique d’un lecteur en cours de maintenance.

PhysMediaId

Identificateur unique d’un élément multimédia physique en cours de maintenance.

Library

Bibliothèque pour cette demande.

SlotId

Identificateur unique d’un emplacement du média physique en cours de maintenance.

TimeQueued

Heure système pendant laquelle cette demande a été mise en file d’attente vers RSM.

TimeCompleted

Heure système pendant laquelle cette demande a été effectuée par RSM.

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.

dwErrorCode

Retour d’erreur pour les demandes qui retournent avec l’état NTMS_LM_FAILED. Il s’agit d’un code d’erreur système.

WorkItemId

ID d’élément de travail associé pour cette demande. Il est actuellement utilisé pour contenir l’ID d’élément de travail à annuler sur une demande de NTMS_LM_REMOVE.

dwPriority

Priorité de l’élément de travail.

Remarques

La structure NTMS_LIBREQUESTINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION .

Le GUID dans les heures de travail peut devenir non valide au fil du temps. Par exemple, un éjection d’un support libre supprime le PMID après l’éjection du média. Toutefois, l’élément de travail n’est pas mis à jour une fois l’éjection terminée.

Notes

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

Voir aussi

NTMS_OBJECTINFORMATION

Partager via