énumération VDS_VOLUME_FLAG (vds.h)

Article
03/08/2023

[À 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