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

另请参阅

VHD 函数