다음을 통해 공유


ConvertInterfaceAliasToLuid 함수(netioapi.h)

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

구문

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

매개 변수

[in] InterfaceAlias

네트워크 인터페이스의 별칭 이름을 포함하는 NULL로 끝나는 유니코드 문자열에 대한 포인터입니다.

[out] InterfaceLuid

이 인터페이스의 NET_LUID 대한 포인터입니다.

반환 값

성공하면 ConvertInterfaceAliasToLuid 는 NO_ERROR 반환합니다. 0이 아닌 반환 값은 오류를 나타내고 NULLInterfaceLuid 매개 변수에 반환됩니다.

오류 코드 의미
ERROR_INVALID_PARAMETER
매개 변수 중 하나가 잘못되었습니다. InterfaceAlias 또는 InterfaceLuid 매개 변수가 NULL이거나 InterfaceAlias 매개 변수가 잘못된 경우 이 오류가 반환됩니다.

설명

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

ConvertInterfaceAliasToLuid 함수는 프로토콜에 독립적이며 IPv6 및 IPv4 프로토콜 모두에 대한 네트워크 인터페이스에서 작동합니다.

요구 사항

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

추가 정보

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex