VDS_VOLUME_PROP2 structure (vds.h)
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]
Définit les propriétés d’un objet volume. Cette structure est identique à la structure VDS_VOLUME_PROP , à ceci près qu’elle inclut également les GUID de volume.
Syntaxe
typedef struct _VDS_VOLUME_PROP2 {
VDS_OBJECT_ID id;
VDS_VOLUME_TYPE type;
VDS_VOLUME_STATUS status;
VDS_HEALTH health;
VDS_TRANSITION_STATE TransitionState;
ULONGLONG ullSize;
ULONG ulFlags;
VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
ULONG cbUniqueId;
LPWSTR pwszName;
BYTE *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;
Membres
id
GUID du volume.
type
Valeur d’énumération VDS_VOLUME_TYPE qui spécifie le type de volume. Les types de volumes sont simples, délimités, rayés (RAID-0), mis en miroir ou rayés avec parité (RAID-5).
status
Valeur d’énumération VDS_VOLUME_STATUS qui spécifie le status du volume.
health
Valeur d’énumération VDS_HEALTH qui spécifie l’état d’intégrité du volume.
TransitionState
Valeur d’énumération VDS_TRANSITION_STATE qui spécifie l’état de transition du volume.
ullSize
Taille du volume, en octets.
ulFlags
Masque de bits de VDS_VOLUME_FLAG valeurs d’énumération qui décrivent le volume.
RecommendedFileSystemType
Valeur d’énumération VDS_FILE_SYSTEM_TYPE qui spécifie le système de fichiers préféré pour le volume. Doit être l’une des suivantes : VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS ou VDS_FST_UNKNOWN.
cbUniqueId
Longueur du tableau d’octets vers lequel pointe le membre pUniqueId .
pwszName
Nom utilisé pour ouvrir un handle pour le volume avec la fonction CreateFile . Par exemple, \ ?\GLOBALROOT\Device\HarddiskVolume1.
pUniqueId
Tableau d’octets qui contient l’identificateur unique du volume.
Remarques
La méthode IVdsVolume2 ::GetProperties2 retourne cette structure pour signaler les propriétés d’un objet volume.
Lorsqu’un volume est hors connexion, l’indicateur VDS_VF_PERMANENTLY_DISMOUNTED est défini dans le membre ulFlags de la structure VDS_VOLUME_PROP2, et la valeur VDS_VS_OFFLINE volume status est également définie dans le membre status de cette structure.
Pour les volumes GPT et dynamiques, l’identificateur unique vers lequel pointe le membre pUniqueId est globalement unique.
Pour les lecteurs multimédias amovibles, le volume existe et a son propre identificateur unique même s’il n’y a pas de média dans l’appareil. Si un volume est mis en forme sur un support amovible, ce volume a son propre identificateur unique. Pour plus d’informations, consultez Prise en charge des demandes mount Manager dans un pilote de classe de stockage.
Le format de l’identificateur unique peut varier selon les types d’appareils et de volumes. Pour les volumes de base sur les disques MBR, l’identificateur unique est basé sur la signature de disque et le décalage de partition. Étant donné que la signature de disque et le décalage de partition sont des valeurs DWORD, l’identificateur unique ne peut pas être garanti comme étant globalement unique entre les ordinateurs.
Si la signature du disque change, l’identificateur unique du volume change également. Les modifications de signature de disque se produisent généralement à la suite d’une collision pendant le clonage de disque.
Notez qu’un identificateur unique n’est pas le même qu’un chemin d’accès GUID de volume. Pour rechercher les chemins d’accès GUID d’un volume, utilisez la méthode IVdsVolumeMF3 ::QueryVolumeGuidPathnames .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | vds.h |