ConvertInterfaceLuidToNameA 함수(netioapi.h)

아티클
08/25/2023

ConvertInterfaceLuidToNameA 함수는 네트워크 인터페이스의 LUID(로컬 고유 식별자)를 ANSI 인터페이스 이름으로 변환합니다.

구문

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PSTR           InterfaceName,
  [in]  SIZE_T         Length
);

매개 변수

[in] InterfaceLuid

네트워크 인터페이스의 NET_LUID 대한 포인터입니다.

[out] InterfaceName

함수가 성공적으로 반환될 때 인터페이스 이름을 포함하는 NULL로 종료된 ANSI 문자열을 저장할 버퍼에 대한 포인터입니다.

[in] Length

InterfaceName 매개 변수가 가리키는 버퍼의 길이(바이트)입니다. 이 값은 인터페이스 이름 및 종료 null 문자를 수용할 수 있을 만큼 커야 합니다. 필요한 최대 길이는 NDIS_IF_MAX_STRING_SIZE + 1입니다.

반환 값

성공하면 ConvertInterfaceLuidToNameA 는 NETIO_ERROR_SUCCESS 반환합니다. 0이 아닌 반환 값은 실패를 나타냅니다.

오류 코드	의미
ERROR_INVALID_PARAMETER	매개 변수 중 하나가 잘못되었습니다. InterfaceLuid 또는 InterfaceName 매개 변수가 NULL이거나 InterfaceLuid 매개 변수가 잘못된 경우 이 오류가 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 사용할 수 있는 스토리지가 부족합니다. InterfaceName 매개 변수가 가리키는 버퍼의 크기가 Length 매개 변수에 지정된 대로 충분히 크지 않아서 인터페이스 이름을 저장할 수 없는 경우 이 오류가 반환됩니다.

설명

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

ConvertInterfaceLuidToNameA 함수는 프로토콜 독립적이며 IPv6 및 IPv4 프로토콜 모두에 대한 네트워크 인터페이스에서 작동합니다. ConvertInterfaceLuidToNameA는 네트워크 인터페이스 LUID를 ANSI 인터페이스 이름으로 변환합니다.

ConvertInterfaceLuidToNameW는 네트워크 인터페이스 LUID를 유니코드 인터페이스 이름으로 변환합니다.

종료 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