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

另请参阅

关于 VHD

GET_VIRTUAL_DISK_INFO

VHD 参考