SetVirtualDiskInformation 函式 (virtdisk.h)

設定虛擬硬碟 (VHD) 的相關信息。

語法

DWORD SetVirtualDiskInformation(
  [in] HANDLE                 VirtualDiskHandle,
  [in] PSET_VIRTUAL_DISK_INFO VirtualDiskInfo
);

[in] VirtualDiskHandle

開啟之虛擬磁碟的句柄，必須使用 VIRTUAL_DISK_ACCESS_METAOPS 旗標開啟。如需如何開啟虛擬磁碟的詳細資訊，請參閱 OpenVirtualDisk 函式。

[in] VirtualDiskInfo

有效 SET_VIRTUAL_DISK_INFO 結構的指標。

要求的狀態。

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

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

如果要求設定 ParentFilePath 成員，但系統無法解析提供的路徑，SetVirtualDiskInformation 函式將會失敗。

設定父資訊也會讓子系的父 GUID 和 Timestamp 字段更新。

此作業正在進行時，無法連結虛擬磁碟。

呼叫端必須具有 READ|對虛擬磁碟備份儲存區的寫入存取權。