if_indextoname 함수(netioapi.h)
if_indextoname 함수는 네트워크 인터페이스의 로컬 인덱스를 ANSI 인터페이스 이름으로 변환합니다.
구문
IPHLPAPI_DLL_LINKAGE PCHAR NETIOAPI_API_ if_indextoname(
[in] NET_IFINDEX InterfaceIndex,
[out] PCHAR InterfaceName
);
매개 변수
[in] InterfaceIndex
네트워크 인터페이스에 대한 로컬 인덱스입니다.
[out] InterfaceName
함수가 성공적으로 반환될 때 인터페이스 이름을 포함하는 NULL로 종료된 ANSI 문자열을 저장할 버퍼에 대한 포인터입니다. 이 매개 변수가 가리키는 버퍼의 길이(바이트)는 IF_NAMESIZE 이상이어야 합니다.
반환 값
성공하면 if_indextoname 인터페이스 이름을 포함하는 NULL로 종료된 ANSI 문자열에 대한 포인터를 반환합니다. 실패 시 NULL 포인터가 반환됩니다.
설명
if_indextoname 함수는 Windows Vista 이상에서 사용할 수 있습니다.
if_indextoname 함수는 인터페이스 인덱스 를 해당 이름에 매핑합니다. 이 함수는 RFC 2553의 IETF에 설명된 대로 IPv6에 대한 기본 소켓 확장의 일부로 설계되었습니다. 자세한 내용은 http://www.ietf.org/rfc/rfc2553.txt를 참조하세요.
if_indextoname 함수는 Unix 환경을 사용하는 애플리케이션의 이식성을 위해 구현되지만 ConvertInterface 함수가 선호됩니다. if_indextoname 함수는 ConvertInterfaceIndexToLuid 함수를 호출하여 인터페이스 인덱스를 NET_LUID 변환한 다음 ConvertInterfaceLuidToNameA를 호출하여 NET_LUID ANSI 인터페이스 이름으로 변환할 수 있습니다.
if_indextoname 실패하고 NULL 포인터를 반환하는 경우 오류 코드를 확인할 수 없습니다.
InterfaceName 매개 변수가 가리키는 버퍼의 길이(바이트)는 NDIS_IF_MAX_STRING_SIZENetioapi.h 헤더 파일에 선언된 값인 IF_NAMESIZE 같거나 커야 합니다. 종료 NULL이 없는 인터페이스 이름 NDIS_IF_MAX_STRING_SIZE 최대 길이는 Ntddndis.h 헤더 파일에 선언됩니다. NDIS_IF_MAX_STRING_SIZEIfdef.h 헤더 파일에 정의된 IF_MAX_STRING_SIZE 상수로 정의됩니다. Ntddndis.h 및 Ifdef.h 헤더 파일은 Iphlpapi.h 헤더 파일에 의해 자동으로 포함되는 Netioapi.h 헤더 파일에 자동으로 포함됩니다. Ntddndis.h, Ifdef.h 및 Netioapi.h 헤더 파일은 직접 사용하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | netioapi.h(Iphlpapi.h 포함) |
| 라이브러리 | Iphlpapi.lib |
| DLL | Iphlpapi.dll |