IVMVirtualPC::FindVirtualMachine メソッド
[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。
要求された構成に一致する仮想マシン オブジェクトを取得します。
構文
HRESULT FindVirtualMachine(
[in] BSTR configurationName,
[out, retval] IVMVirtualMachine **virtualMachine
);
パラメーター
-
configurationName [in]
-
見つかる仮想マシンの名前。
-
virtualMachine [out, retval]
-
この仮想マシンを表す新しい IVMVirtualMachine オブジェクトへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード/値 | 説明 |
|---|---|
|
操作に成功しました。 |
|
指定した構成が見つかりませんでした。 |
|
configurationName パラメーターが無効であるか、virtualMachine が NULL です。 |
|
予期しないエラーが発生しました。 |
|
プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。 |
解説
仮想マシン名では大文字と小文字が区別されません。たとえば、"MyVM" と "myvm" は同じ仮想マシンを参照します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| クライアント サポートの終了 |
Windows 7 |
| 製品 |
Windows Virtual PC |
| ヘッダー |
|
| IID |
IID_IVMVirtualPCは 236ba0d9-a24a-4292-a132-27c1421dfd01 として定義されています |