GetBestInterface 함수(iphlpapi.h)

GetBestInterface 함수는 지정된 IPv4 주소에 가장 적합한 경로가 있는 인터페이스의 인덱스를 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterface(
  [in]  IPAddr dwDestAddr,
  [out] PDWORD pdwBestIfIndex
);

[in] dwDestAddr

IPAddr 구조체의 형태로 가장 적합한 경로가 있는 인터페이스를 검색할 대상 IPv4 주소입니다.

[out] pdwBestIfIndex

dwDestAddr에서 지정한 IPv4 주소에 가장 적합한 경로가 있는 인터페이스의 인덱스를 수신하는 DWORD 변수에 대한 포인터입니다.

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_CAN_NOT_COMPLETE	작업을 완료할 수 없습니다.
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 nULL 포인터가 pdwBestIfIndex 매개 변수에 전달되거나 pdwBestIfIndex 가 쓸 수 없는 메모리를 가리키는 경우 반환됩니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 오류는 로컬 컴퓨터에 IPv4 스택이 없으면 반환됩니다.
기타	FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

GetBestInterface 함수는 IPv4 주소에서만 작동합니다. IPv6 주소와 함께 사용하려면 GetBestInterfaceEx 를 사용해야 합니다.

IPAddr 데이터 형식에 대한 자세한 내용은 Windows 데이터 형식을 참조하세요. 점선 10진수 표기법과 IPAddr 형식 간에 IP 주소를 변환하려면 inet_addr 및 inet_ntoa 함수를 사용합니다.

Windows Vista 이상에서는 pdwBestIfIndex 매개 변수가 IP 도우미에 의해 내부적으로 NET_IFINDEX 데이터 형식에 대한 포인터로 처리됩니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll