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.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
반환 코드 | 설명 |
---|---|
|
작업을 완료할 수 없습니다. |
|
잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 nULL 포인터가 pdwBestIfIndex 매개 변수에 전달되거나 pdwBestIfIndex 가 쓸 수 없는 메모리를 가리키는 경우 반환됩니다. |
|
요청이 지원되지 않습니다. 이 오류는 로컬 컴퓨터에 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 |