ConvertInterfaceIndexToLuid 함수
ConvertInterfaceIndexToLuid 함수는 네트워크 인터페이스의 로컬 인덱스를 인터페이스의 LUID(로컬 고유 식별자)로 변환합니다.
참고
ConvertInterfaceXxx API 제품군은 가상 미니포트, 경량 필터, 터널 어댑터 및 물리적 인터페이스를 포함할 수 있는 TCP/IP에 바인딩된 모든 인터페이스에 대해 식별자를 열거합니다.
구문
NETIOAPI_API ConvertInterfaceIndexToLuid(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PNET_LUID InterfaceLuid
);
매개 변수
InterfaceIndex [in]
네트워크 인터페이스의 로컬 인덱스 값입니다.InterfaceLuid [out]
네트워크 인터페이스의 NET_LUID 공용 구조체에 대한 포인터입니다.
반환 값
ConvertInterfaceIndexToLuid 는 함수가 성공하면 STATUS_SUCCESS 반환합니다. 함수가 실패하면 InterfaceLuid 매개 변수가 NULL로 설정되고 ConvertInterfaceIndexToLuid 는 다음 오류 코드를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 매개 변수 중 하나가 잘못되었습니다. InterfaceLuid 매개 변수가 NULL이거나 InterfaceIndex 매개 변수가 잘못된 경우 ConvertInterfaceIndexToLuid는 이 오류를 반환합니다. |
설명
ConvertInterfaceIndexToLuid 함수는 프로토콜에 독립적이며 IPv6 및 IPv4 프로토콜 모두에 대한 네트워크 인터페이스에서 작동합니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
PASSIVE_LEVEL |