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 |