if_indextoname 함수

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

구문

PCHAR NETIOAPI_API_ if_indextoname(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PCHAR       InterfaceName
);

매개 변수

• InterfaceIndex [in]
  네트워크 인터페이스의 로컬 인덱스입니다.

• InterfaceName [out]
  NULL로 종료된 ANSI 문자열을 저장할 버퍼에 대한 포인터입니다. if_indextoname 성공하면 InterfaceName에는 ANSI 인터페이스 이름이 포함됩니다. 이 매개 변수가 가리키는 버퍼의 길이(바이트)는 IF_NAMESIZE 보다 크거나 같아야 합니다. IF_NAMESIZE 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 값

이 함수가 성공하면 if_indextoname 인터페이스 이름을 포함하는 NULL로 종료된 ANSI 문자열에 대한 포인터를 반환합니다. 이 함수가 실패하면 if_indextonameNULL 포인터를 반환합니다.

설명

if_indextoname 함수는 인터페이스 인덱스 를 해당 이름에 매핑합니다. 이 함수는 RFC 2553의 IETF에 설명된 대로 IPv6에 대한 기본 소켓 확장의 일부로 설계되었습니다.

if_indextoname 함수는 Unix 환경에서 드라이버의 이식성을 위해 구현되지만 ConvertInterfaceXxx 함수는 네트워크 인터페이스 식별자를 변환하는 데 선호되는 방법입니다. if_indextoname 함수를 ConvertInterfaceIndexToLuid 함수를 호출하여 인터페이스 인덱스를 NET_LUID 공용 구조체로 변환한 다음 ConvertInterfaceLuidToNameA 함수를 호출하여 NET_LUID ANSI 인터페이스 이름으로 변환할 수 있습니다.

InterfaceName 매개 변수가 가리키는 버퍼의 길이(바이트)는 IF_NAMESIZE 같거나 커야 합니다. IF_NAMESIZE 값은 Netioapi.h 헤더 파일에 NDIS_IF_MAX_STRING_SIZE 동일하게 정의됩니다. 종료 NULL 문자가 없는 인터페이스 이름 NDIS_IF_MAX_STRING_SIZE 최대 길이는 Ntddndis.h 헤더 파일에 선언됩니다. NDIS_IF_MAX_STRING_SIZE Ifdef.h 헤더 파일에 정의된 IF_MAX_STRING_SIZE 상수로 정의됩니다.

if_indextoname 함수가 실패하고 NULL 포인터를 반환하는 경우 오류 코드를 확인할 수 없습니다.

요구 사항

추가 정보

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID