IVMVirtualPC::CreateVirtualMachine メソッド
[Windows Virtual PC は、Windows 8の時点で使用できなくなります。 代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。
新しい仮想マシン構成を作成し、仮想マシン オブジェクトを取得します。
構文
HRESULT CreateVirtualMachine(
[in] BSTR configurationName,
[in] BSTR configurationPath,
[out, retval] IVMVirtualMachine **virtualMachine
);
パラメーター
-
configurationName [in]
-
作成する仮想マシンの名前。 名前の長さは 80 文字を超えることはできません。また、VMC ファイルと VMCX ファイルへの名前とパスの合計長は 、MAX_PATH (260) 文字を超えることはできません。 構成ファイルの作成時に、仮想マシン名の末尾にファイル名拡張子 .vmc と .vmcx が追加されます。 このパラメーターが NULL または空の文字列の場合、 configurationPath パラメーターは VMC ファイルへの完全なパスを指定する必要があります。
-
configurationPath [in]
-
VMC ファイルを格納するフォルダーへのパス。 このフォルダーが存在しない場合は作成されます。 configurationName が NULL または空の文字列の場合は、新しい構成ファイルの完全なパスを指定する必要があります。
-
virtualMachine [out, retval]
-
この仮想マシンを表す新しい IVMVirtualMachine オブジェクトへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード/値 | 説明 |
---|---|
|
操作に成功しました。 |
|
configurationName パラメーターまたは configurationPath パラメーターが無効であるか、virtualMachine パラメーターが NULL です。 |
|
configurationPath パラメーターで指定されたパスが見つかりません。 |
|
configurationPath パラメーターに無効な文字 ("*?:<>/|"のいずれか) が含まれています。 |
|
configurationPath パラメーターは、空または相対パスを指定します。 絶対パスが必要です。 |
|
configurationName パラメーターと configurationPath パラメーターで指定されたパスは、長すぎるパスになります。 パスの合計長は 、MAX_PATH (260) 文字未満にする必要があります。 |
|
この名前の構成ファイルは、この場所に既に存在します。 |
|
configurationName パラメーターが空です。 |
|
configurationName パラメーターの長さが 80 文字を超えています。 |
|
configurationName パラメーターに無効な文字 ("*?:<>/|\") が含まれています。 |
|
この名前の仮想マシンは既に存在します。 |
|
プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。 |
|
予期しないエラーが発生しました。 |
解説
仮想マシン名では大文字と小文字が区別されません。たとえば、"MyVM" と "myvm" は同じ仮想マシンを参照します。
必要条件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
サポートなし |
クライアント サポートの終了 |
Windows 7 |
製品 |
Windows Virtual PC |
Header |
|
IID |
IID_IVMVirtualPCは 236ba0d9-a24a-4292-a132-27c1421dfd01 として定義されます |