IVMVirtualPC::CreateDynamicVirtualHardDisk メソッド

  • [アーティクル]

[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。

動的にサイズ変更する仮想ハード ディスクを作成します。

構文

HRESULT CreateDynamicVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

パラメーター

imagePath [in]

新しいディスク イメージ ファイルへの完全パス。 含まれているフォルダーが存在しない場合は作成されます。

size [in]

イメージのサイズ (メガバイト単位)。 この値は、最大 2,088,960 MB (2040 GB) にすることができます。

diskTask [out, retval]

イメージの作成を追跡するために使用される IVMTask オブジェクト。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターが NULL です。
E_INVALIDARG
0x80000003
 size パラメーターが 0 以下です。
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 imagePath パラメーターで指定されたパスが見つかりません。
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE)
0x8007000f
 imagePath パラメーターで指定されたファイルは、CD-ROM または DVD-ROM 上にあります。
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 imagePath パラメーターに無効な文字 ("*?:<>/|"のいずれか) が含まれています。
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 imagePath パラメーターはどちらも、空または相対パスを指定します。 少なくとも 1 つのパラメーターが絶対パスである必要があります。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 imagePath パラメーターで指定されたパスが長すぎます。 パスの長さは 260 文字未満にする必要があります。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 imagePath パラメーターによって参照されるファイルは既に存在します。
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 動的に拡張される仮想ハード ディスク イメージには、ホスト ボリュームで少なくとも 8 MB の空き容量が必要です。
VM_E_IMAGE_SIZE_TOO_LARGE
0xA0040683
 パラメーター のサイズ は 2,088,960 MB 未満である必要があります。 形式が FAT16 の場合、サイズは 2000 MB 未満である必要があります。
VM_E_IMAGE_SIZE_TOO_SMALL
0xA0040684
 フォーマットされていない仮想ハード ディスク イメージと FAT16 形式の仮想ハード ディスク イメージは、少なくとも 3 MB である必要があります。 FAT32 形式の仮想ハード ディスク イメージは、少なくとも 514 MB である必要があります。
VM_E_FILE_TOO_LARGE_FOR_VOLUME
0xA0040679
 動的に拡張される仮想ハード ディスク イメージが最大制限まで拡張された場合、ホスト ボリュームはこのサイズのファイルをサポートできません。 FAT32 ボリュームの最大ファイル サイズは 4 GB です。 FAT16 ボリュームの最大ファイル サイズは 2 GB です。
VM_E_APP_SHUTTING_DOWN
0xA0040209
 アプリケーションのシャットダウンが開始された後は、仮想ハード ディスクを作成できません。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
製品
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPCは 236ba0d9-a24a-4292-a132-27c1421dfd01 として定義されています

関連項目

IVMVirtualPC