SetVirtualDiskMetadata 函式 (virtdisk.h)

設定虛擬磁碟的元數據專案。

語法

DWORD SetVirtualDiskMetadata(
  [in] HANDLE     VirtualDiskHandle,
  [in] const GUID *Item,
  [in] ULONG      MetaDataSize,
  [in] const void *MetaData
);

參數

[in] VirtualDiskHandle

開啟虛擬磁碟的句柄。

[in] Item

識別要設定之元數據的 GUID 位址。 這不能是 NULL GUID (所有零的 GUID) 。

[in] MetaDataSize

ULONG 的位址，其中包含 MetaData 參數所指向緩衝區的大小，以位元組為單位。 特定 VHD 檔案類型每個元數據元素的大小上限。 特定 VHD 檔案也有元數據項目總數和元數據大小總計的最大值。

[in] MetaData

包含要儲存之元數據的緩衝區位址。

傳回值

要求的狀態。

如果函式成功，傳回值會 ERROR_SUCCESS。

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

規格需求

另請參閱

VHD 函式