IVMVirtualNetwork::HostAdapter プロパティ

  • [アーティクル]

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

仮想ネットワークが接続されているアダプターの名前を取得します。

このプロパティは読み取り専用です。

構文

HRESULT get_HostAdapter(
  [out, retval] BSTR *hostAdapter
);

プロパティ値

仮想ネットワークが接続されているホスト アダプターの名前。

エラー コード

名前/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターが NULL です。
VM_E_ADAPTER_NOT_FOUND
0xA0040700
 この仮想ネットワークが接続されたホスト イーサネット アダプターは使用できなくなりました。 ホスト イーサネット アダプターが削除されたか無効になっている可能性があります。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

解説

仮想ネットワーク アダプターを使用すると、仮想ネットワークを外部ネットワークと通信できます。 通常、ホスト コンピューターにはイーサネット アダプターごとに 1 つのアダプターがインストールされます。 たとえば、ホスト マシンに "10/100 ENET" というラベルの付いたアダプターがあるとします。 仮想 NIC を "10/100 ENET" に接続するネットワークに接続するには、仮想ネットワークの Network HostAdapter プロパティを "10/100 ENET" に設定し、仮想 NIC をこの仮想ネットワークに接続します。

HostAdapter プロパティが空の文字列 ("") に設定されている場合、仮想 NIC アダプターは "Internal Network" または "Shared Networking (NAT)" ネットワークに接続されます。 "内部ネットワーク" ネットワークに接続されている仮想 NIC は、システム ホスト上の外部ネットワークにアクセスできません。 ただし、この仮想ネットワークに接続されている仮想 NIC は、引き続き相互に通信できます。

アダプターの完全な一覧には、 IVMHostInfo::NetworkAdapters プロパティを使用してアクセスできます。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
製品
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualNetworkは 431cb7a1-2469-4563-b94e-38b987adca63 として定義されています

関連項目

IVMVirtualNetwork