énumération VDS_DISK_FLAG (vds.h)

Article
03/13/2024

[À 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 l’ensemble d’indicateurs valides pour un objet de disque.

Note À l’exception de VDS_DF_READ_ONLY, ces indicateurs ne peuvent pas être définis à l’aide de la méthode IVdsDisk ::SetFlags ou effacés à l’aide de la méthode IVdsDisk ::ClearFlags .

Syntax

typedef enum _VDS_DISK_FLAG {
  VDS_DF_AUDIO_CD = 0x1,
  VDS_DF_HOTSPARE = 0x2,
  VDS_DF_RESERVE_CAPABLE = 0x4,
  VDS_DF_MASKED = 0x8,
  VDS_DF_STYLE_CONVERTIBLE = 0x10,
  VDS_DF_CLUSTERED = 0x20,
  VDS_DF_READ_ONLY = 0x40,
  VDS_DF_SYSTEM_DISK = 0x80,
  VDS_DF_BOOT_DISK = 0x100,
  VDS_DF_PAGEFILE_DISK = 0x200,
  VDS_DF_HIBERNATIONFILE_DISK = 0x400,
  VDS_DF_CRASHDUMP_DISK = 0x800,
  VDS_DF_HAS_ARC_PATH = 0x1000,
  VDS_DF_DYNAMIC = 0x2000,
  VDS_DF_BOOT_FROM_DISK = 0x4000,
  VDS_DF_CURRENT_READ_ONLY = 0x8000,
  VDS_DF_REFS_NOT_SUPPORTED = 0x10000
} VDS_DISK_FLAG;

Constantes


`VDS_DF_AUDIO_CD` Valeur : 0x1 Le média d’un lecteur DE CD-ROM ou de DVD est un CD audio.
`VDS_DF_HOTSPARE` Valeur : 0x2 Le disque est réservé pour une utilisation uniquement en tant que disque de secours à chaud.
`VDS_DF_RESERVE_CAPABLE` Valeur : 0x4 Cet indicateur est réservé pour une utilisation future. Ne pas utiliser.
`VDS_DF_MASKED` Valeur : 0x8 Le disque est masqué.
`VDS_DF_STYLE_CONVERTIBLE` Valeur : 0x10 Le style de partition sur le disque peut être converti entre MBR et GPT.
`VDS_DF_CLUSTERED` Valeur : 0x20 Le disque est en cluster.
`VDS_DF_READ_ONLY` Valeur : 0x40 Cet indicateur indique que l’attribut en lecture seule du disque, qui est géré par le système d’exploitation Windows, est défini. Cet attribut peut être défini à l’aide de la méthode IVdsDisk ::SetFlags et effacé à l’aide de la méthode IVdsDisk ::ClearFlags . Cet indicateur et l’attribut correspondant ne reflètent pas nécessairement l’état réel en lecture seule du disque, qui est indiqué par l’indicateur VDS_DF_CURRENT_READ_ONLY . Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_SYSTEM_DISK` Valeur : 0x80 Le disque héberge le volume système actuel. Si le disque est dynamique et que le volume est un miroir, l’indicateur est défini sur le disque qui contient le plex utilisé comme volume système au démarrage. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_BOOT_DISK` Valeur : 0x100 Le disque héberge le volume de démarrage actuel. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_PAGEFILE_DISK` Valeur : 0x200 Le disque contient un fichier de page. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_HIBERNATIONFILE_DISK` Valeur : 0x400 Le disque contient le volume de mise en veille prolongée. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_CRASHDUMP_DISK` Valeur : 0x800 Le disque contient le volume crashdump. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_HAS_ARC_PATH` Valeur : 0x1000 Le disque est visible par l’ordinateur au démarrage. Pour GPT, cet indicateur est défini pour tous les disques. Pour MBR, il est défini uniquement pour les disques visibles par le microprogramme BIOS de l’ordinateur. (Il s’agit généralement des 12 premiers disques connectés à l’ordinateur et visibles par le BIOS au démarrage.) Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_DYNAMIC` Valeur : 0x2000 Le disque est un disque dynamique. Windows Vista et Windows Server 2003 : Non pris en charge avant Windows Vista avec SP1 et Windows Server 2008.
`VDS_DF_BOOT_FROM_DISK` Valeur : 0x4000 Cet indicateur est défini sur le disque dur à partir duquel l’ordinateur est configuré pour démarrer. Sur les ordinateurs qui utilisent le microprogramme BIOS, il s’agit du premier disque dur que le microprogramme détecte au démarrage de l’ordinateur (appareil 80H ou 81H si 80H est affecté à un périphérique flash USB). Si l’utilisateur branche un périphérique flash USB sur l’ordinateur avant le démarrage, cela peut entraîner l’attribution du périphérique 80H au périphérique USB et peut entraîner l’attribution du premier disque dur 81H détecté par le microprogramme. Notez que dans ce cas, cet indicateur n’est pas défini sur le périphérique flash USB. Sur les ordinateurs qui utilisent l’interface EFI (Extended Firmware Interface), cet indicateur est défini sur le disque qui contient la partition système EFI (ESP) utilisée pour démarrer l’ordinateur. Notez que si aucun des disques ne contient d’ESP ou s’il existe plusieurs ESP, cet indicateur n’est défini sur aucun des disques. Windows Server 2008, Windows Vista et Windows Server 2003 : Cet indicateur n’est pas pris en charge.
`VDS_DF_CURRENT_READ_ONLY` Valeur : 0x8000 Cet indicateur indique que le disque est en lecture seule. S’il n’est pas défini, le disque est en lecture/écriture. Contrairement à l’indicateur VDS_DF_READ_ONLY , qui est utilisé pour modifier l’attribut en lecture seule du disque géré par le système d’exploitation Windows, cet indicateur reflète l’état réel du disque. Cet indicateur ne peut pas être défini à l’aide de la méthode IVdsDisk ::SetFlags ou effacé à l’aide de la méthode IVdsDisk ::ClearFlags . Le disque sera dans un état en lecture seule si son attribut en lecture seule est défini. Toutefois, un disque peut être dans un état en lecture seule même si son attribut en lecture seule n’est pas défini, si le matériel sous-jacent est en lecture seule. Par exemple, si le numéro d’unité logique est en lecture seule ou s’il s’agit d’un disque dur virtuel qui réside sur un volume en lecture seule, le matériel sous-jacent est en lecture seule et, par conséquent, le disque est en lecture seule. Windows Server 2008, Windows Vista et Windows Server 2003 : Cet indicateur n’est pas pris en charge.
`VDS_DF_REFS_NOT_SUPPORTED` Valeur : 0x10000

Remarques

Cette énumération fournit les valeurs du membre ulFlags des structures VDS_DISK_PROP et VDS_DISK_PROP2 . La structure VDS_DISK_PROP est retournée par la méthode IVdsDisk ::GetProperties . La structure VDS_DISK_PROP2 est retournée par la méthode IVdsDisk3 ::GetProperties2 .

Toutes les valeurs d’indicateur VDS_DISK_FLAG sont définies par le service VDS ; ils ne peuvent pas être définis par les applications. Une exception est l’indicateur VDS_DF_READ_ONLY , qui peut être défini à l’aide de la méthode IVdsDisk ::SetFlags et effacé à l’aide de la méthode IVdsDisk ::ClearFlags .

Les disques USB et les CD-ROMs ont les restrictions et fonctionnalités suivantes :

Les disques dynamiques ne sont pas pris en charge sur les disques USB (y compris les disques durs amovibles USB et les lecteurs flash USB).
Un disque USB amovible ne peut pas être utilisé comme disque de démarrage.
Vous pouvez créer un disque RAM WinPE démarrable sur un lecteur flash USB ou un CD-ROM. Windows Server 2003 : Non pris en charge.
Un lecteur flash USB ne peut avoir qu’une seule partition. Le type de partition peut être MBR ou GPT.

Note Des constantes supplémentaires peuvent être ajoutées à l’énumération VDS_DISK_FLAG dans les futures versions de Windows. Pour cette raison, votre application doit être conçue pour gérer correctement une constante d’énumération VDS_DISK_FLAG non reconnue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	vds.h