VDS_VOLUME_FLAG 枚举 (vds.h)

项目
03/08/2023

[从Windows 8和Windows Server 2012开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

定义卷对象的一组有效标志。

语法

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;

常量


`VDS_VF_SYSTEM_VOLUME` 值： 0x1 卷是系统卷。
`VDS_VF_BOOT_VOLUME` 值： 0x2 卷是启动卷。
`VDS_VF_ACTIVE` 值： 0x4 卷处于活动状态。也就是说，的 bootIndicator 值基础分区设置为 true。
`VDS_VF_READONLY` 值： 0x8 该卷具有驱动器号和装载管理器分配的卷 GUID 名称，并由 FindFirstVolume 和 FindNextVolume 函数枚举。但是，卷是只读的。此标志不适用于 CD-ROM 或 DVD 设备。
`VDS_VF_HIDDEN` 值： 0x10 卷没有驱动器号和装载管理器分配的卷 GUID 名称。 FindFirstVolume 和 FindNextVolume 函数不枚举卷。可以使用其设备名称打开卷，并且可以从中读取或写入打开的卷。卷设备名称的一个示例是 \？\GLOBALROOT\Device\HarddiskVolumeX。此标志不适用于 CD-ROM 或 DVD 设备。
`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 在调用方可用于安装操作系统的动态卷下创建硬分区。清除此标志会导致删除分区。只能为动态磁盘设置或清除此标志;它始终设置为基本磁盘。此标志不适用于 CD-ROM 或 DVD 设备。
`VDS_VF_LBN_REMAP_ENABLED` 值： 0x800 VDS 可以动态更改卷在磁盘上的位置。此标志对基本标志无效或动态卷，仅受某些第三方卷管理器支持。
`VDS_VF_FORMATTING` 值： 0x1000 正在格式化卷。
`VDS_VF_NOT_FORMATTABLE` 值： 0x2000 无法格式化卷。此标志适用于可移动的小型便携式内存设备设备、CDROM 设备和 DVD 设备。对于 CD 和 DVD 设备，在中存在媒体时，始终会设置驱动器，如果驱动器中没有媒体，则不设置。
`VDS_VF_NTFS_NOT_SUPPORTED` 值： 0x4000 卷不支持 NTFS，但可以支持其他文件系统。此标志适用于小型便携式内存设备、可移动设备、CDROM 设备和 DVD 设备。
`VDS_VF_FAT32_NOT_SUPPORTED` 值： 0x8000 卷不支持 FAT32。此标志适用于可移动的小型便携式内存设备设备、CDROM 设备和 DVD 设备。
`VDS_VF_FAT_NOT_SUPPORTED` 值： 0x10000 卷不支持 FAT。此标志适用于可移动的小型便携式内存设备设备、CDROM 设备和 DVD 设备。
`VDS_VF_NO_DEFAULT_DRIVE_LETTER` 值： 0x20000 操作系统不会在下次将卷添加到计算机时自动分配驱动器号。如果清除，操作系统会在某些情况下向卷分配驱动器号。对于基本 GPT 卷，分配或删除驱动器号将切换此标志。此标志不适用于 CD-ROM 或 DVD 设备。 Windows Server 2003：在动态卷上，始终设置此标志，无法清除。在基本卷上，默认清除它，只能通过调用 IVdsVolume：：SetFlags 或 IVdsVolume：：ClearFlags 方法进行设置或清除。
`VDS_VF_PERMANENTLY_DISMOUNTED` 值： 0x40000 卷处于脱机状态。卷打开将在脱机卷上成功。但是，针对脱机卷的 I/O 将失败。将访问路径（如驱动器号）分配给脱机卷会导致该卷处于联机状态。若要设置此标志，请调用 IVdsVolumeMF：:D ismount 方法，将 bForce 和 bPermanent 参数设置为 TRUE。此标志不适用于 CD-ROM 或 DVD 设备。 Windows Server 2003：不支持取消动态卷的大纲。当卷处于脱机状态时，此标志在 VDS_VOLUME_PROP 结构的 ulFlags 成员中设置，VDS_VS_OFFLINE标志也在VDS_VOLUME_PROP或VDS_VOLUME_PROP2结构的状态成员中设置。Windows Server 2008、Windows Vista 和 Windows Server 2003：不支持VDS_VS_OFFLINE标志。
`VDS_VF_PERMANENT_DISMOUNT_SUPPORTED` 值： 0x80000 卷可以脱机。
`VDS_VF_SHADOW_COPY` 值： 0x100000 该卷是另一个卷的卷影副本。此标志是在创建卷影副本时设置的。它为从原始卷中断卷影副本时清除。 VDS_VF_SHADOW_COPY 标志指示文件系统筛选器基于驱动程序的软件 (，例如防病毒程序) 以避免附加到卷。应用程序可以使用属性来区分卷影复制卷与生产卷。应用程序执行快速恢复，其中通过清除只读和隐藏的卷影复制 LUN 成为非卷影副本 bit 也需要清除此位。此标志不适用于 CD-ROM 或 DVD 设备。 Windows Server 2003：在具有 SP1 的 Windows Server 2003 之前，不支持此标志。
`VDS_VF_FVE_ENABLED` 值： 0x200000 卷受 BitLocker 全卷加密保护。此标志不适用于 CD-ROM 或 DVD 设备。 Windows Server 2003：不支持此标志。
`VDS_VF_DIRTY` 值： 0x400000 设置了卷的脏位。 Windows Server 2003：不支持此标志。
`VDS_VF_REFS_NOT_SUPPORTED` 值： 0x800000
`VDS_VF_BACKS_BOOT_VOLUME` 值： 0x1000000
`VDS_VF_BACKED_BY_WIM_IMAGE` 值： 0x2000000

注解

在 MBR 基本磁盘上，只能为整个磁盘设置卷标志，而不能为单个卷设置卷标志。

如果在 MBR 磁盘上设置了 VDS_VF_NO_DEFAULT_DRIVE_LETTER 标志，则会保留所有现有的驱动器号，但不会将新的驱动器号分配给磁盘上的卷。

此枚举为 VDS_VOLUME_PROP 结构的 ulFlags 成员以及 IVdsVolume：：SetFlags 和 IVdsVolume：：ClearFlags 方法的 ulFlags 参数提供值。

下表比较了 MBR 基本磁盘、GPT 基本磁盘和动态磁盘上的 VDS_VF_NO_DEFAULT_DRIVE_LETTER 标志的行为。

功能	MBR 基本磁盘	GPT 基本磁盘	MBR 或 GPT 动态磁盘
默认情况下会清除VDS_VF_NO_DEFAULT_DRIVE_LETTER标志。但是，可以通过调用 IVdsVolume：：SetFlags 来设置此标志。	是的。	是的。	是的。Windows Server 2003：此标志始终为动态磁盘设置，无法清除。
分配或删除驱动器号会切换VDS_VF_NO_DEFAULT_DRIVE_LETTER标志设置。	否，因为已为整个磁盘设置或清除此标志。	是，因为已为单个卷设置或清除此标志。	是的。Windows Server 2003：此标志始终为动态磁盘设置，无法清除。