GetVirtualDiskMetadata 函数 (virtdisk.h)
从虚拟磁盘检索指定的元数据。
语法
DWORD GetVirtualDiskMetadata(
[in] HANDLE VirtualDiskHandle,
[in] const GUID *Item,
[in, out] PULONG MetaDataSize,
[out] PVOID MetaData
);
参数
[in] VirtualDiskHandle
打开的虚拟磁盘的句柄。
[in] Item
标识要检索的元数据的 GUID 的地址。
[in, out] MetaDataSize
ULONG 的地址。 输入时，该值指示 MetaData 参数指向的缓冲区的大小（以字节为单位）。 输出时，该值包含检索到的元数据的大小（以字节为单位）。 如果缓冲区太小，API 将失败并返回 ERROR_INSUFFICIENT_BUFFER，将所需大小放在 ULONG 中，缓冲区将包含元数据的开头。
[out] MetaData
要存储元数据的缓冲区的地址。
返回值
请求的状态。
如果函数成功，则返回值 ERROR_SUCCESS。
如果 Items 参数指向的缓冲区太小，则返回值 ERROR_INSUFFICIENT_BUFFER。
如果函数失败，则返回值为错误代码。 有关详细信息，请参阅 系统错误代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 |
| 最低受支持的服务器 | Windows Server 2012 |
| 目标平台 | Windows |
| 标头 | virtdisk.h (包括 Windows.h) |
| Library | VirtDisk.lib |
| DLL | VirtDisk.dll |