EnumerateVirtualDiskMetadata 函数 (virtdisk.h)

  • 项目

枚举与虚拟磁盘关联的元数据。

语法

DWORD EnumerateVirtualDiskMetadata(
  [in]      HANDLE VirtualDiskHandle,
  [in, out] PULONG NumberOfItems,
  [out]     GUID   *Items
);

参数

[in] VirtualDiskHandle

打开的虚拟磁盘的句柄。

[in, out] NumberOfItems

ULONG 的地址。 输入时，该值指示 Items 参数指向的缓冲区中的元素数。 输出时，值包含检索到的项数。 如果缓冲区太小，API 将失败并返回 ERROR_INSUFFICIENT_BUFFER 并且 ULONG 将包含所需的缓冲区大小。

[out] Items

要用表示元数据的 GUID填充的缓冲区的地址。 GetVirtualDiskMetadata 函数可用于检索每个 GUID 表示的数据。

返回值

请求的状态。

如果函数成功，则返回值 ERROR_SUCCESS。

如果 Items 参数指向的缓冲区太小，则返回值 ERROR_INSUFFICIENT_BUFFER。

如果函数失败，则返回值为错误代码。 有关详细信息，请参阅 系统错误代码。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 virtdisk.h (包括 Windows.h)
Library VirtDisk.lib
DLL VirtDisk.dll

另请参阅

VHD 函数