if_nametoindex 함수(netioapi.h)

아티클
03/05/2024

if_nametoindex 함수는 네트워크 인터페이스의 ANSI 인터페이스 이름을 인터페이스의 로컬 인덱스로 변환합니다.

구문

IPHLPAPI_DLL_LINKAGE NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  [in] PCSTR InterfaceName
);

매개 변수

[in] InterfaceName

인터페이스 이름을 포함하는 NULL로 종료된 ANSI 문자열에 대한 포인터입니다.

반환 값

성공하면 if_nametoindex 로컬 인터페이스 인덱스가 반환됩니다. 실패하면 0이 반환됩니다.

설명

if_nametoindex 함수는 Windows Vista 이상에서 사용할 수 있습니다.

if_nametoindex 함수는 인터페이스 이름을 해당 인덱스로 매핑합니다. 이 함수는 RFC 2553의 IETF에서 설명한 대로 IPv6에 대한 기본 소켓 확장의 일부로 설계되었습니다. 자세한 내용은 http://www.ietf.org/rfc/rfc2553.txt를 참조하세요.

if_nametoindex 함수는 Unix 환경을 사용하는 애플리케이션의 이식성을 위해 구현되지만 ConvertInterface 함수가 선호됩니다. if_nametoindex 함수를 ConvertInterfaceNameToLuidA 함수를 호출하여 ANSI 인터페이스 이름을 NET_LUID 변환한 다음 ConvertInterfaceLuidToIndex를 호출하여 NET_LUID 로컬 인터페이스 인덱스로 변환할 수 있습니다.

if_nametoindex 함수가 실패하고 0을 반환하는 경우 오류 코드를 확인할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	netioapi.h(Iphlpapi.h 포함)
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll