VDS_VOLUME_PROP2 结构 (vds.h)

  • 项目

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

定义 卷对象的属性。 此结构与 VDS_VOLUME_PROP 结构相同，只不过它还包括卷 GUID。

语法

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

成员

id

卷的 GUID。

type

指定卷类型的 VDS_VOLUME_TYPE 枚举值。 卷类型为简单、跨区、条带化 (RAID-0) 、镜像或带区化奇偶校验 (RAID-5) 。

status

一个VDS_VOLUME_STATUS枚举值，该值指定卷的状态。

health

一个VDS_HEALTH枚举值，该值指定卷的运行状况。

TransitionState

一个VDS_TRANSITION_STATE枚举值，该值指定卷的转换状态。

ullSize

卷的大小（以字节为单位）。

ulFlags

描述卷 的VDS_VOLUME_FLAG 枚举值的位掩码。

RecommendedFileSystemType

一个VDS_FILE_SYSTEM_TYPE枚举值，该值指定卷的首选文件系统。 必须是下列值之一：VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、VDS_FST_UDF、VDS_FST_CDFS或VDS_FST_UNKNOWN。

cbUniqueId

pUniqueId 成员指向的字节数组的长度。

pwszName

用于使用 CreateFile 函数打开卷句柄的名称。 例如，\？\GLOBALROOT\Device\HarddiskVolume1。

pUniqueId

包含卷的唯一标识符的字节数组。

注解

IVdsVolume2：：GetProperties2 方法返回此结构以报告卷对象的属性。

当卷处于脱机状态时，VDS_VF_PERMANENTLY_DISMOUNTED标志在 VDS_VOLUME_PROP2 结构的 ulFlags 成员中设置，并且VDS_VS_OFFLINE卷状态值也在此结构的 status 成员中设置。

对于 GPT 和动态卷， pUniqueId 成员指向的唯一标识符是全局唯一的。

对于可移动媒体驱动器，卷存在，并且具有其自己的唯一标识符，即使设备中没有媒体也是如此。 如果在可移动媒体上格式化卷，则该卷具有其自己的唯一标识符。 有关详细信息，请参阅 支持存储类驱动程序中的装载管理器请求。

唯一标识符的格式可能因不同类型的设备和卷而异。 对于 MBR 磁盘上的基本卷，唯一标识符基于磁盘签名和分区偏移量。 由于磁盘签名和分区偏移量是 DWORD 值，因此无法保证唯一标识符在计算机之间全局唯一。

如果磁盘签名发生更改，卷的唯一标识符也会更改。 磁盘签名更改通常是由于磁盘克隆期间发生冲突而导致的。

请注意，唯一标识符与卷 GUID 路径不同。 若要查找卷的卷 GUID 路径，请使用 IVdsVolumeMF3：：QueryVolumeGuidPathnames 方法。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 vds.h

另请参阅

IVdsVolume2：：GetProperties2

MOUNTDEV_UNIQUE_ID

VDS 结构

VDS_FILE_SYSTEM_TYPE

VDS_HEALTH

VDS_TRANSITION_STATE

VDS_VOLUME_FLAG

VDS_VOLUME_STATUS

VDS_VOLUME_TYPE