다음을 통해 공유


IVMVirtualNetwork::HostAdapter 속성

[Windows 가상 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
예기치 않은 오류가 발생했습니다.

설명

가상 네트워크 어댑터를 사용하면 가상 네트워크가 외부 네트워크와 통신할 수 있습니다. 일반적으로 호스트 머신에 설치된 이더넷 어댑터당 하나의 어댑터가 있습니다. 예를 들어 호스트 컴퓨터에 "10/100 ENET"이라는 레이블이 지정된 어댑터가 있다고 가정해 보겠습니다. 가상 NIC를 "10/100 ENET"에 연결된 네트워크에 연결하려면 가상 네트워크의 네트워크 HostAdapter 속성을 "10/100 ENET"으로 설정하고 가상 NIC를 이 가상 네트워크에 연결합니다.

HostAdapter 속성이 빈 문자열("")로 설정된 경우 가상 NIC 어댑터는 "내부 네트워크" 또는 "NAT(공유 네트워킹)" 네트워크에 연결됩니다. "내부 네트워크" 네트워크에 연결된 가상 NIC는 시스템 호스트의 외부 네트워크에 액세스할 수 없습니다. 그러나 이 가상 네트워크에 연결된 가상 NIC는 여전히 서로 통신할 수 있습니다.

어댑터의 전체 목록은 IVMHostInfo::NetworkAdapters 속성을 통해 액세스할 수 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버
지원되는 버전 없음
클라이언트 지원 종료
Windows 7
제품
Windows Virtual PC
헤더
VPCCOMInterfaces.h
IID
IID_IVMVirtualNetwork 431cb7a1-2469-4563-b94e-38b987adca63으로 정의됩니다.

추가 정보

IVMVirtualNetwork