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。

如果函式失敗，則傳回值是錯誤碼。如需詳細資訊，請參閱系統錯誤碼。