if_nametoindex 함수
if_nametoindex 함수는 네트워크 인터페이스의 ANSI 인터페이스 이름을 인터페이스의 로컬 인덱스로 변환합니다.
구문
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
매개 변수
- InterfaceName [in]
인터페이스 이름을 포함하는 NULL로 끝나는 ANSI 문자열에 대한 포인터입니다.
반환 값
함수가 성공하면 if_nametoindex 로컬 인터페이스 인덱스를 반환합니다. 함수가 실패하면 if_nametoindex 0을 반환합니다.
설명
if_nametoindex 함수는 인터페이스 이름을 해당 인덱스로 매핑합니다. 이 함수는 RFC 2553의 IETF에 설명된 대로 IPv6에 대한 기본 소켓 확장의 일부로 설계되었습니다.
if_nametoindex 함수는 Unix 환경을 사용하는 드라이버의 이식성을 위해 구현되지만 ConvertInterfaceXxx 함수는 네트워크 인터페이스 식별자를 변환하는 기본 방법입니다. if_nametoindex 함수를 ConvertInterfaceNameToLuidA 함수를 호출하여 ANSI 인터페이스 이름을 NET_LUID 공용 구조체로 변환한 다음 ConvertInterfaceLuidToIndex 함수를 호출하여 NET_LUID 로컬 인터페이스 인덱스로 변환할 수 있습니다.
if_nametoindex 함수가 실패하고 0을 반환하는 경우 오류 코드를 확인할 수 없습니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
PASSIVE_LEVEL |