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 オブジェクトへのポインター。

戻り値

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

リターン コード/値 説明
S_OK
0
 操作に成功しました。
S_FALSE
1
 指定した構成が見つかりませんでした。
E_POINTER
0x80004003
 configurationName パラメーターが無効であるか、virtualMachine が NULL です。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 プロセッサは、ハードウェア アクセラレータ仮想化 (HAV) 拡張機能をサポートしていません。

解説

仮想マシン名では大文字と小文字が区別されません。たとえば、"MyVM" と "myvm" は同じ仮想マシンを参照します。

必要条件

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

関連項目

IVMVirtualPC