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