structure NTMS_PMIDINFORMATIONA (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_PMIDINFORMATION définit les propriétés propres à un objet multimédia physique.

Syntaxe

typedef struct _NTMS_PMIDINFORMATIONA {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID MediaType;
  NTMS_GUID HomeSlot;
  CHAR      szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  CHAR      szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATIONA;

Membres

CurrentLibrary

ID unique de la bibliothèque dans laquelle le média est contenu.

MediaPool

ID unique du pool de supports auquel le média est affecté.

Location

ID unique de l’objet d’emplacement physique pour le média.

LocationType

Type d’emplacement actuel d’un élément multimédia physique. La valeur de ce membre peut être définie sur NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT. (Les supports hors connexion sont dans les emplacements.)

MediaType

ID unique d’un objet de type multimédia.

HomeSlot

ID unique de l’emplacement de stockage de bibliothèque dans lequel le média est stocké.

szBarCode[NTMS_BARCODE_LENGTH]

Chaîne qui correspond à la valeur de code à barres sur une étiquette de code barre d’un élément multimédia physique.

BarCodeState

État actuel du code à barres. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_BARCODESTATE_OK	Le média a un code à barres et il est lisible.
NTMS_BARCODESTATE_UNREADABLE	Le média n’a pas de code à barres ou le code à barres n’est pas lisible.

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

Nombre séquentiel attribué au support spécifié sous la forme d’une valeur lisible par l’homme qui doit être transcrit par un utilisateur sur le support afin que le support puisse se trouver dans une bibliothèque hors connexion.

MediaState

État actuel de l’élément multimédia physique. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_MEDIASTATE_IDLE	Le média se trouve dans un emplacement de la bibliothèque, dans un lecteur démonté ou dans une bibliothèque hors connexion.
NTMS_MEDIASTATE_INUSE	Le média est marqué comme étant utilisé dès qu’une demande d’opération est effectuée avec succès sur RSM.
NTMS_MEDIASTATE_LOADED	État du média lorsque RSM a déterminé que le média est disponible pour la lecture et l’écriture.
NTMS_MEDIASTATE_MOUNTED	État d’un élément multimédia physique lorsque le média est placé dans un lecteur.
NTMS_MEDIASTATE_OP_ERROR	Le support physique est dans un état d’erreur récupérable. Aucune intervention d’opérateur n’est requise.
NTMS_MEDIASTATE_UNLOADED	État du média lorsqu’il est prêt à être supprimé d’un lecteur. L’état du lecteur, DISMOUNTABLE, indique également qu’un lecteur peut être supprimé à tout moment.
NTMS_MEDIASTATE_OPREQ	Le média attend la demande d’opérateur.

dwNumberOfPartitions

Nombre de côtés sur le milieu.

dwMediaTypeCode

Code de type de média SCSI.

dwDensityCode

Code de densité SCSI.

MountedPartition

ID global unique du côté du média actuellement monté.

Remarques

La structure NTMS_PMIDINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION.

Note

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