structure NTMS_LIBREQUESTINFORMATIONW (ntmsapi.h)

Article
11/20/2024

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

La structure NTMS_LIBREQUESTINFORMATION définit les propriétés spécifiques à une demande de travail, qui sont mises en file d’attente vers RSM.

Syntaxe

typedef struct _NTMS_LIBREQUESTINFORMATIONW {
  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;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONW;

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ésactivez un lecteur.
NTMS_LM_DISABLEMEDIA	Désactivez le support.
NTMS_LM_DISMOUNT	Démonter le support à partir d’un lecteur.
NTMS_LM_DOORACCESS	Autoriser l’accès au média 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	Activez 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éservez un emplacement plus propre.
NTMS_LM_UPDATEOMID	Mettez à jour l’OMID.
NTMS_LM_WRITESCRATCH	Écrire 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	L’opération s’est terminée correctement.
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 service.

DriveId

Identificateur unique d’un lecteur en cours de service.

PhysMediaId

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

Library

Bibliothèque pour cette demande.

SlotId

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

TimeQueued

Heure système pendant laquelle cette requête 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]

Utilisateur interactif 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 requête. 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 ne pas être valide au fil du temps. Par exemple, un éjection d’un support libre supprime le PMID une fois que le média est éjecté. Toutefois, l’élément de travail n’est pas mis à jour à la fin de l’éjection.

Note

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

Voir aussi

NTMS_OBJECTINFORMATION

Partager via