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| が必要です。仮想ディスクのバッキングストアへの書き込みアクセス。