IVMNetworkAdapter インターフェイス
[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。
仮想ネットワーク インターフェイス カード (NIC) へのインターフェイスとして機能します。 仮想マシンのネットワークの設定方法を設定するために使用されます。 ネットワーク インターフェイス カードは、 IVMVirtualMachine::AddNetworkAdapter と IVMVirtualMachine::RemoveNetworkAdapter を使用して追加および削除できます。 IVMVirtualMachine::NetworkAdapters または IVMVirtualNetwork::NetworkAdapters プロパティから返された IVMNetworkAdapterCollection コレクションから IVMNetworkAdapter オブジェクトを取得することもできます。
メンバー
IVMNetworkAdapter インターフェイスは、IDispatch インターフェイスから継承されます。 IVMNetworkAdapter には、次の種類のメンバーもあります。
メソッド
IVMNetworkAdapter インターフェイスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| _Id | このネットワーク インターフェイスの内部識別子を取得します。 |
| AttachToVirtualNetwork | 指定した仮想ネットワークにネットワーク インターフェイスをアタッチします。 |
| DetachFromVirtualNetwork | ネットワーク インターフェイスを仮想ネットワークからデタッチします。 |
プロパティ
IVMNetworkAdapter インターフェイスには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
EthernetAddress |
読み取り/書き込み |
ネットワーク インターフェイスのイーサネット (MAC) アドレス。 |
|
IsEthernetAddressDynamic |
読み取り/書き込み |
イーサネット アドレスが動的に生成されるかどうかを示します。 |
|
VirtualMachine |
読み取り専用 |
このネットワーク インターフェイスに関連付けられている仮想マシン。 |
|
VirtualNetwork |
読み取り専用 |
ネットワーク インターフェイスが接続されている仮想ネットワーク。 |
解説
ネットワーク インターフェイスの既定のイーサネット アドレスは"00-00-00-00-00-00"で、ほとんどのオペレーティング システムでは無効なイーサネット アドレスと見なされます。 IsEthernetAddressDynamic が FALSE に設定されている場合、EthernetAddress は有効なイーサネット ネットワーク アドレスで初期化する必要があります。
次の手順では、 IVMNetworkAdapter インターフェイスの使用方法について説明します。
ホスト NIC に仮想 NIC をアタッチするには
- 仮想 (ゲスト) NIC はホスト NIC に直接接続されません。 代わりに、仮想 NIC は、ホスト NIC に接続されている仮想ネットワークに接続されます。 仮想ネットワークの構成の詳細については、「 IVMVirtualNetwork」を参照してください。 仮想 NIC を仮想ネットワークにアタッチするには、 AttachToVirtualNetwork メソッドを使用します。
仮想ネットワークから仮想 NIC を切断するには
- DetachFromVirtualNetwork メソッドは、仮想ネットワークから仮想 NIC をデタッチします。 この関数が呼び出されると、 VirtualNetwork プロパティは無効な仮想ネットワーク ID を返します。
仮想 NIC オブジェクトがある場合に仮想マシンから仮想 NIC を削除するには
- VirtualMachine プロパティを使用して、仮想 NIC に関連付けられている仮想マシンを取得します。
- 現在の オブジェクトを IVMVirtualMachine::RemoveNetworkAdapter メソッドのパラメーターとして使用します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| クライアント サポートの終了 |
Windows 7 |
| 製品 |
Windows Virtual PC |
| Header |
|
| IID |
IID_IVMNetworkAdapterは e32e4165-22b8-4dc0-8d57-850171ae207a として定義されています |