IVMVirtualPC::FindVirtualNetwork メソッド

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

要求された名前と一致する仮想ネットワーク オブジェクトを取得します。

構文

HRESULT FindVirtualNetwork(
  [in]          BSTR              virtualNetworkName,
  [out, retval] IVMVirtualNetwork **virtualNetwork
);

パラメーター

virtualNetworkName [in]

検索する仮想ネットワークの名前。

virtualNetwork [out, retval]

この仮想ネットワークを表す新しい IVMVirtualNetwork オブジェクトへのポインター。

戻り値

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

リターン コード/値 説明
S_OK
0
操作に成功しました。
S_FALSE
1
指定された仮想ネットワークが見つかりませんでした。
E_POINTER
0x80004003
virtualNetwork パラメーターが NULL であるか、仮想ネットワークが見つかりません。
E_INVALIDARG
0x80000003
virtualNetworkName パラメーターが無効であるか、空の文字列です。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
仮想ネットワーク ファイルが見つかりませんでした。
DISP_E_EXCEPTION
0x80020009
予期しないエラーが発生しました。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
プロセッサは、ハードウェア 高速化仮想化 (HAV) 拡張機能をサポートしていません。

解説

仮想ネットワーク名では、大文字と小文字が区別されません。たとえば、"MyNetwork" と "mynetwork" は同じ仮想ネットワークを参照します。

要件

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

こちらもご覧ください

IVMVirtualPC