次の方法で共有

IVMVirtualPC::CreateDifferencingVirtualHardDisk メソッド

  • [アーティクル]

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

差分仮想ハード ディスクを作成します。

構文

HRESULT CreateDifferencingVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          BSTR    parentPath,
  [out, retval] IVMTask **diskTask
);

パラメーター

imagePath [in]

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

parentPath [in]

親ディスク イメージ ファイルへのパス。

diskTask [out, retval]

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

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターが NULL です。
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 imagePath パラメーターまたは parentPath パラメーターで指定されたパスが見つかりません。
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE)
0x8007000f
 imagePath パラメーターで指定されたファイルは、CD-ROM または DVD-ROM 上にあります。
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 imagePath または parentPath パラメーターに無効な文字 ("*?:<>/|") が含まれています。
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 imagePath パラメーターと parentPath パラメーターの両方で、空または相対パスを指定します。 少なくとも 1 つのパラメーターは絶対パスである必要があります。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 imagePath パラメーターまたは parentPath パラメーターで指定されたパスが長すぎます。 パスの長さは 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
 予期しないエラーが発生しました。

解説

imagePath または parentPath は相対パスにすることができますが、これらの少なくとも 1 つは絶対パスである必要があります。 1 つのパス パラメーターが相対パスの場合は、もう一方のパス パラメーターに対する相対パスと見なされます。

必要条件

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

関連項目

IVMVirtualPC