structure NTMS_PARTITIONINFORMATIONA (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_PARTITIONINFORMATION définit les propriétés propres à l’objet latéral.

Syntaxe

typedef struct _NTMS_PARTITIONINFORMATIONA {
  NTMS_GUID     PhysicalMedia;
  NTMS_GUID     LogicalMedia;
  DWORD         State;
  WORD          Side;
  DWORD         dwOmidLabelIdLength;
  BYTE          OmidLabelId[NTMS_OMIDLABELID_LENGTH];
  CHAR          szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH];
  CHAR          szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH];
  DWORD         dwMountCount;
  DWORD         dwAllocateCount;
  LARGE_INTEGER Capacity;
} NTMS_PARTITIONINFORMATIONA;

Membres

PhysicalMedia

Identificateur de média physique unique pour le support qui contient ce côté.

LogicalMedia

Identificateur de média logique unique (LMID) pour un élément de média logique qui contient ce côté. Ce paramètre est une NULL si le côté n’est pas alloué.

State

Informations sur le cycle de vie côté. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_PARTSTATE_ALLOCATED	Le média a été alloué à une application.
NTMS_PARTSTATE_AVAILABLE	Le média est disponible pour être alloué.
NTMS_PARTSTATE_COMPLETE	Le média a été entièrement écrit et marqué comme terminé par une application.
NTMS_PARTSTATE_DECOMMISIONED	Le support n’est pas adapté au stockage de données et n’est plus utilisable.
NTMS_PARTSTATE_INCOMPATIBLE	Le média a été détecté et marqué comme incompatible avec le lecteur.
NTMS_PARTSTATE_FOREIGN	Le média se trouve dans un pool non reconnu.
NTMS_PARTSTATE_IMPORT	Le média se trouve dans le pool d’importation.
NTMS_PARTSTATE_UNPREPARED	Le média attend qu’une étiquette gratuite soit appliquée.
NTMS_PARTSTATE_RESERVED	Le côté a été réservé par la fonction AllocateNtmsMedia avec le paramètre dwOption défini sur NTMS_ALLOCATE_NEW.

Side

Valeur relative zéro qui indique quel côté d’un média multi-côté il s’agit. Pour les supports à face unique, tels que la bande, cette valeur est toujours égale à zéro. Pour un support double face, un enregistrement NTMS_PARITIONINFORMATION a cette propriété définie sur zéro ( côté « A » et un deuxième enregistrement NTMS_PARTITIONINFORMATION a la valeur 1 - côté « B ».

dwOmidLabelIdLength

Longueur de la chaîne d’ID d’étiquette de l’identificateur sur média.

OmidLabelId[NTMS_OMIDLABELID_LENGTH]

Identificateur unique de l’ID d’étiquette de l’identificateur sur média.

szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH]

Type d’étiquette de l’identificateur sur média.

szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH]

Informations d’étiquette de l’identificateur sur le support.

dwMountCount

Nombre de fois où ce média a été monté dans un lecteur. Cette opération est initialisée à zéro lorsque les objets sont créés dans la base de données.

dwAllocateCount

Nombre de fois où ce média a été alloué.

Capacity

Nombre d’octets de stockage disponibles sur ce côté.

Remarques

La structure NTMS_PARTITIONINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION.

Note

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