Partager via


énumération VDS_VOLUME_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 volume.

Syntax

typedef enum _VDS_VOLUME_FLAG {
  VDS_VF_SYSTEM_VOLUME = 0x1,
  VDS_VF_BOOT_VOLUME = 0x2,
  VDS_VF_ACTIVE = 0x4,
  VDS_VF_READONLY = 0x8,
  VDS_VF_HIDDEN = 0x10,
  VDS_VF_CAN_EXTEND = 0x20,
  VDS_VF_CAN_SHRINK = 0x40,
  VDS_VF_PAGEFILE = 0x80,
  VDS_VF_HIBERNATION = 0x100,
  VDS_VF_CRASHDUMP = 0x200,
  VDS_VF_INSTALLABLE = 0x400,
  VDS_VF_LBN_REMAP_ENABLED = 0x800,
  VDS_VF_FORMATTING = 0x1000,
  VDS_VF_NOT_FORMATTABLE = 0x2000,
  VDS_VF_NTFS_NOT_SUPPORTED = 0x4000,
  VDS_VF_FAT32_NOT_SUPPORTED = 0x8000,
  VDS_VF_FAT_NOT_SUPPORTED = 0x10000,
  VDS_VF_NO_DEFAULT_DRIVE_LETTER = 0x20000,
  VDS_VF_PERMANENTLY_DISMOUNTED = 0x40000,
  VDS_VF_PERMANENT_DISMOUNT_SUPPORTED = 0x80000,
  VDS_VF_SHADOW_COPY = 0x100000,
  VDS_VF_FVE_ENABLED = 0x200000,
  VDS_VF_DIRTY = 0x400000,
  VDS_VF_REFS_NOT_SUPPORTED = 0x800000,
  VDS_VF_BACKS_BOOT_VOLUME = 0x1000000,
  VDS_VF_BACKED_BY_WIM_IMAGE = 0x2000000
} VDS_VOLUME_FLAG;

Constantes

 
VDS_VF_SYSTEM_VOLUME
Valeur : 0x1
Le volume est un volume système.
VDS_VF_BOOT_VOLUME
Valeur : 0x2
Le volume est le volume de démarrage.
VDS_VF_ACTIVE
Valeur : 0x4
Le volume est actif. Autrement dit, la valeur bootIndicator du
la partition sous-jacente est définie sur true.
VDS_VF_READONLY
Valeur : 0x8
Le volume a une lettre de lecteur et un nom GUID de volume attribué par le gestionnaire de montage, et est énuméré par les fonctions FindFirstVolume et FindNextVolume . Toutefois, le volume est en lecture seule. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.
VDS_VF_HIDDEN
Valeur : 0x10
Le volume n’a pas de lettre de lecteur et un nom GUID de volume attribué par le Gestionnaire de montage. Le volume n’est pas énuméré par les fonctions FindFirstVolume et FindNextVolume . Le volume peut être ouvert à l’aide de son nom d’appareil, et le volume ouvert peut être lu ou écrit dans. Un exemple de nom de périphérique de volume est \ ?\GLOBALROOT\Device\HarddiskVolumeX. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.
VDS_VF_CAN_EXTEND
Valeur : 0x20
La taille du volume peut être étendue.
VDS_VF_CAN_SHRINK
Valeur : 0x40
La taille du volume peut être réduite.
VDS_VF_PAGEFILE
Valeur : 0x80
Le volume contient un fichier de page.
VDS_VF_HIBERNATION
Valeur : 0x100
Le volume contient un fichier de mise en veille prolongée.
VDS_VF_CRASHDUMP
Valeur : 0x200
Le volume contient le fichier de vidage sur incident.
VDS_VF_INSTALLABLE
Valeur : 0x400
VDS crée une partition matérielle sous un volume dynamique que les appelants peuvent utiliser pour installer un système d’exploitation. L’effacement de cet indicateur entraîne la suppression de la partition. Cet indicateur peut être défini ou effacé uniquement pour les disques dynamiques ; il est toujours défini pour les disques de base. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.
VDS_VF_LBN_REMAP_ENABLED
Valeur : 0x800
VDS peut modifier dynamiquement la position du volume sur le disque. Cet indicateur n’est pas valide pour les données de base
ou des volumes dynamiques et est pris en charge uniquement par certains gestionnaires de volumes tiers.
VDS_VF_FORMATTING
Valeur : 0x1000
Le volume est en cours de mise en forme.
VDS_VF_NOT_FORMATTABLE
Valeur : 0x2000
Impossible de mettre en forme le volume. Cet indicateur s’applique aux petits périphériques à mémoire portable, amovibles
appareils, périphériques CDROM et appareils DVD. Pour les périphériques CD et DVD, cette option est toujours définie quand il y a un média dans le
drive, et n’est pas défini s’il n’y a pas de média dans le lecteur.
VDS_VF_NTFS_NOT_SUPPORTED
Valeur : 0x4000
Le volume ne prend pas en charge NTFS, mais peut prendre en charge d’autres systèmes de fichiers. Cet indicateur s’applique à small
les périphériques de mémoire portables, les appareils amovibles, les périphériques CDROM et les appareils DVD.
VDS_VF_FAT32_NOT_SUPPORTED
Valeur : 0x8000
Le volume ne prend pas en charge FAT32. Cet indicateur s’applique aux petits périphériques à mémoire portable, amovibles
appareils, périphériques CDROM et appareils DVD.
VDS_VF_FAT_NOT_SUPPORTED
Valeur : 0x10000
Le volume ne prend pas en charge FAT. Cet indicateur s’applique aux petits périphériques à mémoire portable, amovibles
appareils, périphériques CDROM et appareils DVD.
VDS_VF_NO_DEFAULT_DRIVE_LETTER
Valeur : 0x20000
Le système d’exploitation n’affecte pas automatiquement de lettre de lecteur la prochaine fois que le volume est ajouté à l’ordinateur.
S’il est effacé, le système d’exploitation affecte une lettre de lecteur au volume dans certaines conditions. Pour gpT de base
l’attribution ou la suppression d’une lettre de lecteur bascule cet indicateur. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.

Windows Server 2003 : Sur les volumes dynamiques, cet indicateur est toujours défini et ne peut pas être effacé. Sur les volumes de base, il est effacé par défaut et peut être défini ou effacé uniquement en appelant la méthode IVdsVolume ::SetFlags ou IVdsVolume ::ClearFlags .
VDS_VF_PERMANENTLY_DISMOUNTED
Valeur : 0x40000
Le volume est hors ligne. L’ouverture du volume réussit sur un volume hors connexion. Toutefois, les E/S sur un volume hors connexion échouent. L’attribution d’un chemin d’accès, tel qu’une lettre de lecteur, à un volume hors connexion entraîne sa mise en ligne. Pour définir cet indicateur, appelez IVdsVolumeMF ::D ismount
méthode, définissant les paramètres bForce et bPermanent sur
TRUE. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.

Windows Server 2003 : La désactivation des volumes dynamiques n’est pas prise en charge.

Lorsqu’un volume est hors connexion, cet indicateur est défini dans le membre ulFlags de la structure VDS_VOLUME_PROP, et l’indicateur VDS_VS_OFFLINE est également défini dans le membre status de la structure VDS_VOLUME_PROP ou VDS_VOLUME_PROP2.Windows Server 2008, Windows Vista et Windows Server 2003 : l’indicateur VDS_VS_OFFLINE n’est pas pris en charge.
VDS_VF_PERMANENT_DISMOUNT_SUPPORTED
Valeur : 0x80000
Le volume peut être mis hors connexion.
VDS_VF_SHADOW_COPY
Valeur : 0x100000
Le volume est un cliché instantané d’un autre volume. Cet indicateur est défini lors de la création du cliché instantané. Elle est
effacé lorsque le cliché instantané est rompu du volume d’origine. Le VDS_VF_SHADOW_COPY
indicateur est une indication pour les logiciels basés sur les pilotes de filtre de système de fichiers (par exemple,
programmes antivirus) pour éviter de s’attacher à
. L’attribut peut être utilisé par les applications pour différencier les volumes de cliché instantané des volumes de production. Applications qui
effectuer une récupération rapide où un numéro d’unité logique de cliché instantané est transformé en un autre que le cliché instantané en effaçant la lecture seule et masquée
bit doit également effacer ce bit. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.


Windows Server 2003 : Cet indicateur n’est pas pris en charge avant Windows Server 2003 avec SP1.
VDS_VF_FVE_ENABLED
Valeur : 0x200000
Le volume est protégé par le chiffrement de volume complet BitLocker. Cet indicateur ne s’applique pas aux périphériques CD-ROM ou DVD.

Windows Server 2003 : Cet indicateur n’est pas pris en charge.
VDS_VF_DIRTY
Valeur : 0x400000
Le bit sale du volume est défini.

Windows Server 2003 : Cet indicateur n’est pas pris en charge.
VDS_VF_REFS_NOT_SUPPORTED
Valeur : 0x800000
VDS_VF_BACKS_BOOT_VOLUME
Valeur : 0x1000000
VDS_VF_BACKED_BY_WIM_IMAGE
Valeur : 0x2000000

Remarques

Sur un disque de base MBR, les indicateurs de volume ne peuvent être définis que pour l’ensemble du disque, et non pour des volumes individuels.

Si l’indicateur VDS_VF_NO_DEFAULT_DRIVE_LETTER est défini sur un disque MBR, toutes les lettres de lecteur existantes sont conservées, mais aucune nouvelle lettre de lecteur n’est affectée aux volumes sur le disque.

Cette énumération fournit des valeurs pour le membre ulFlags de la structure VDS_VOLUME_PROP et le paramètre ulFlags des méthodes IVdsVolume ::SetFlags et IVdsVolume ::ClearFlags .

Le tableau suivant compare le comportement de l’indicateur VDS_VF_NO_DEFAULT_DRIVE_LETTER sur les disques de base MBR, les disques de base GPT et les disques dynamiques.

Fonctionnalité Disques de base MBR Disques de base GPT Disques dynamiques MBR ou GPT
L’indicateur VDS_VF_NO_DEFAULT_DRIVE_LETTER est effacé par défaut. Toutefois, cet indicateur peut être défini en appelant IVdsVolume ::SetFlags. Oui. Oui. Oui. Windows Server 2003 : Cet indicateur est toujours défini pour les disques dynamiques et ne peut pas être effacé.
L’affectation ou la suppression d’une lettre de lecteur bascule le paramètre d’indicateur VDS_VF_NO_DEFAULT_DRIVE_LETTER. Non, car cet indicateur est défini ou effacé pour l’ensemble du disque. Oui, car cet indicateur est défini ou effacé pour des volumes individuels. Oui. Windows Server 2003 : Cet indicateur est toujours défini pour les disques dynamiques et ne peut pas être effacé.
 

Pour créer un volume de démarrage sur un disque dynamique, vous devez définir l’indicateur VDS_VF_INSTALLABLE pour le volume, puis mettre en forme le volume en appelant la méthode IVdsVolumeMF ::Format .

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

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

IVdsVolume ::ClearFlags

IVdsVolume ::SetFlags

IVdsVolumeMF ::D ismount

Énumérations VDS

VDS_PARTITION_INFO_MBR

VDS_SAN_POLICY

VDS_VOLUME_PROP