ExpandVirtualDisk 関数 (virtdisk.h)

固定または動的に展開可能な仮想ハード ディスク (VHD) のサイズを大きくします。

構文

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

パラメーター

[in] VirtualDiskHandle

開いている仮想ディスクへのハンドル。 VIRTUAL_DISK_ACCESS_METAOPS フラグを使用して開かれている必要があります。 仮想ディスクを開く方法については、 OpenVirtualDisk 関数を参照してください。

[in] Flags

EXPAND_VIRTUAL_DISK_FLAG列挙のEXPAND_VIRTUAL_DISK_FLAG_NONE値である必要があります。

[in] Parameters

拡張パラメーター データを含む有効な EXPAND_VIRTUAL_DISK_PARAMETERS 構造体へのポインター。

[in, optional] Overlapped

非同期操作が必要な場合は、有効な OVERLAPPED 構造体への省略可能なポインター。

戻り値

要求の状態。

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値はエラー コードです。 詳細については、「 システム エラー コード」を参照してください。

注釈

ExpandVirtualDisk 関数は操作をインプレースで実行するため、仮想ディスクは作成されません。

展開操作は、固定および展開可能な仮想ディスクに対してのみ有効であり、差分仮想ディスク チェーンが無効になります。

仮想ディスクを展開するには、操作中に仮想ディスクをデタッチする必要があります。

呼び出し元には READ| が必要です。仮想ディスクのバッキング ストアへの書き込みアクセス。

展開可能な仮想ディスクの場合、 ExpandVirtualDisk 関数では、サイズが仮想であり、実際に使用されるまで物理的に大きくならないため、ファイルが大きくなる可能性があります。

仮想ディスクが拡張可能で、ホスト ボリュームに新しいサイズ用の十分な領域がない場合、 ExpandVirtualDisk 関数は成功します。 仮想ディスクが拡張されると、ホスト ボリュームの領域が不足すると、仮想ディスクへの今後の書き込みが失敗する可能性があります。

要件

こちらもご覧ください

VHD について

VHD リファレンス