GetVirtualDiskInformation 函数 (virtdisk.h)
检索有关虚拟硬盘的信息 (VHD) 。
语法
DWORD GetVirtualDiskInformation(
[in] HANDLE VirtualDiskHandle,
[in, out] PULONG VirtualDiskInfoSize,
[in, out] PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
[in, out, optional] PULONG SizeUsed
);
参数
[in] VirtualDiskHandle
打开的 VHD 的句柄,该句柄必须已使用 OpenVirtualDisk 函数的 VirtualDiskAccessMask 参数中设置的 VIRTUAL_DISK_ACCESS_GET_INFO 标志打开。 有关如何打开 VHD 的信息,请参阅 OpenVirtualDisk 函数。
[in, out] VirtualDiskInfoSize
指向包含 VirtualDiskInfo 参数大小的 ULONG 的指针。
[in, out] VirtualDiskInfo
指向有效 GET_VIRTUAL_DISK_INFO 结构的指针。 返回的数据的格式取决于调用方在 Version 成员中传递的值。
[in, out, optional] SizeUsed
指向包含所用大小的 ULONG 的指针。
返回值
请求的状态。
如果函数成功,则返回值 ERROR_SUCCESS 并且 VirtualDiskInfo 参数包含请求的信息。
如果函数失败,则返回值为错误代码, 并且 VirtualDiskInfo 参数未定义。 有关详细信息,请参阅 系统错误代码。
注解
只要使用 VIRTUAL_DISK_ACCESS_GET_INFO 标志打开句柄,就可以在任何有效的 VirtualDiskHandle 上调用 GetVirtualDiskInformation 函数。 VHD 不需要是附加磁盘。
要求
最低受支持的客户端 | Windows 7 |
最低受支持的服务器 | Windows Server 2008 R2 |
目标平台 | Windows |
标头 | virtdisk.h |
Library | VirtDisk.lib |
DLL | VirtDisk.dll |