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。

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

規格需求

另請參閱

VHD 函式