次の方法で共有

IVMHardDisk::MergeTo メソッド

  • [アーティクル]

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

差分仮想ハード ディスクとそのすべての親 (ルート親仮想ハード ディスクを含む) を新しいハード ディスク ファイルにマージします。

構文

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

パラメーター

newDiskImagePath [in]

選択したディスク イメージがマージされる新しいターゲット ディスク イメージへのパス。

newDiskImageType [in]

新しいターゲット ディスク イメージの種類。 新しいターゲット ディスク イメージに対して許可されるイメージの種類は 、vmDiskType_Dynamic され 、vmDiskType_FixedSizeされます。 詳細については、「 VMHardDiskType」を参照してください。

mergeTask [out, retval]

マージ プロセスの完了を追跡するために使用される IVMTask オブジェクト。

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターが NULL です。
E_INVALIDARG
0x80000003
 newDiskImagePath パラメーターが空です。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 システムは、newDiskImagePath パラメーターで指定されたファイルを見つけることができません。
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 システムは、newDiskImagePath パラメーターで指定されたパスを見つけることができません。
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 newDiskImagePath パラメーターに無効な文字が含まれています (次のいずれか: "*?<>/|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 newDiskImagePath パラメーターは、空または相対パスを指定します。 絶対パスが必要です。
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 newDiskImagePath パラメーターで指定されたパスが長すぎます。 パスは 260 文字未満にする必要があります。
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 このオブジェクトによって参照される仮想ハード ディスクが使用中か、この仮想ハード ディスクの親が使用されています。
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 このエラーは、 この IVMHardDisk オブジェクトによって参照される仮想ハード ディスク イメージが差分ディスク イメージではないか、 パラメーター newDiskImageType が受け入れ可能な値 、 vmDiskType_Dynamic 、 またはvmDiskType_FixedSizeの 1 つではないことが原因で発生します。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 newDiskImagePath パラメーターによって参照されるファイルは既に存在します。
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 ホスト ボリュームに、この仮想ハード ディスクをマージするための十分な領域がありません。
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
 このオブジェクトによって参照される仮想ハード ディスクの親が存在しません。
VM_E_APP_SHUTTING_DOWN
0xA0040209
 アプリケーションがシャットダウンしているため、仮想ハード ディスク イメージをマージできません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

要件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
Product
 Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
 IID_IVMHardDiskは ffa14ae6-48f5-42a4-8a22-186f2e5c7db0 として定義されています

関連項目

IVMHardDisk