Partager via


énumération VDS_DISK_FLAG (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 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

Voir aussi

IVdsDisk3 ::GetProperties2

IVdsDisk ::ClearFlags

IVdsDisk ::GetProperties

IVdsDisk ::SetFlags

VDS_DISK_PROP

VDS_DISK_PROP2