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。

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