IVMHardDisk::Convert メソッド
[Windows Virtual PC は、Windows 8の時点で使用できなくなります。 代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。
固定サイズの仮想ハード ディスクを動的に拡張する仮想ハード ディスクに変換するか、動的に拡張する仮想ハード ディスクを固定サイズの仮想ハード ディスクに変換します。
構文
HRESULT Convert(
[in] BSTR convertedDiskImagePath,
[in] VMHardDiskType convertedDiskImageType,
[out, retval] IVMTask **convertTask
);
パラメーター
-
convertedDiskImagePath [in]
-
ターゲット ディスク イメージ ファイルへのパス。
-
convertedDiskImageType [in]
-
ターゲット ディスク イメージの種類。 値の一覧については、「 VMHardDiskType」を参照してください。
-
convertTask [out, retval]
-
変換プロセスの完了を追跡するために使用される IVMTask オブジェクト。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード/値 | 説明 |
---|---|
|
操作に成功しました。 |
|
convertedDiskImagePath パラメーターが空であるか、ファイル名に .vhd 拡張子がありません。 |
|
パラメーターが NULL です。 |
|
システムは、 convertedDiskImagePath パラメーターで指定されたパスを見つけることができません。 |
|
convertedDiskImagePath パラメーターに無効な文字が含まれています ("*?<>/|":"). |
|
convertedDiskImagePath パラメーターは、空または相対パスを指定します。 絶対パスが必要です。 |
|
convertedDiskImagePath パラメーターで指定されたパスが長すぎます。 パスは 、MAX_PATH (260) 文字未満である必要があります。 |
|
このオブジェクトによって参照される仮想ハード ディスクが使用中か、この仮想ハード ディスクの親が使用されています。 |
|
ホスト ボリュームには、この仮想ハード ディスクを変換するための十分な領域がありません。 |
|
convertedDiskImagePath パラメーターによって参照されるファイルは既に存在します。 |
|
convertedDiskImagePath パラメーターは、vmDiskType_DynamicまたはvmDiskType_FixedSizeである必要があります。 |
|
この IVMHardDisk オブジェクトによって参照される仮想ハード ディスク イメージは、有効なイメージではないようです。 |
|
このオブジェクトによって参照される仮想ハード ディスクの親が存在しません。 |
|
アプリケーションがシャットダウンしているため、仮想ハード ディスク イメージを変換できません。 |
|
予期しないエラーが発生しました。 |
解説
変換プロセスの後、ソース ファイルはそのまま残ります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
サポートなし |
クライアント サポートの終了 |
Windows 7 |
Product |
Windows Virtual PC |
ヘッダー |
|
IID |
IID_IVMHardDiskは ffa14ae6-48f5-42a4-8a22-186f2e5c7db0 として定義されています |