ConvertInterfaceLuidToAlias 함수
ConvertInterfaceLuidToAlias 함수는 네트워크 인터페이스에 대한 LUID(로컬 고유 식별자)를 인터페이스 별칭으로 변환합니다.
참고
ConvertInterfaceXxx API 제품군은 가상 미니포트, 경량 필터, 터널 어댑터 및 물리적 인터페이스를 포함할 수 있는 TCP/IP에 바인딩된 모든 인터페이스에 대해 식별자를 열거합니다.
구문
NETIOAPI_API ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
매개 변수
InterfaceLuid [in]
네트워크 인터페이스에 대한 NET_LUID 공용 구조체에 대한 포인터입니다.InterfaceAlias [out]
NULL로 끝나는 유니코드 문자열을 저장할 버퍼에 대한 포인터입니다. ConvertInterfaceLuidToAlias가 성공적으로 반환되면 InterfaceAlias에는 네트워크 인터페이스의 별칭 이름이 포함됩니다.길이 [in]
InterfaceAlias 매개 변수가 가리키는 버퍼의 길이(문자 수 기준)입니다. 이 값은 네트워크 인터페이스의 별칭 이름과 종료되는 NULL 문자를 저장할 수 있을 만큼 커야 합니다. 허용되는 최대 길이는 NDIS_IF_MAX_STRING_SIZE + 1입니다. NDIS_IF_MAX_STRING_SIZE 대한 자세한 내용은 다음 주의 섹션을 참조하세요.
반환 값
ConvertInterfaceLuidToAlias는 함수가 성공하면 STATUS_SUCCESS 반환합니다. 함수가 실패하면 ConvertInterfaceLuidToAlias 는 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 매개 변수 중 하나가 잘못되었습니다. InterfaceLuid 또는 InterfaceAlias가 NULL이거나 InterfaceLuid가 잘못된 경우 ConvertInterfaceLuidToAlias는 이 오류를 반환합니다. |
| STATUS_NOT_ENOUGH_MEMORY | 사용 가능한 스토리지가 부족합니다. ConvertInterfaceLuidToAlias 는 InterfaceAlias 매개 변수가 가리키는 버퍼의 크기가 Length 매개 변수에 지정된 크기만큼 크지 않아 버퍼가 별칭 이름을 보유할 수 없는 경우 이 오류를 반환합니다. |
설명
ConvertInterfaceLuidToAlias 함수는 프로토콜 독립적이며 IPv6 및 IPv4 프로토콜 모두에 대한 네트워크 인터페이스에서 작동합니다.
종료 NULL 문자가 없는 네트워크 인터페이스의 별칭 이름 NDIS_IF_MAX_STRING_SIZE 최대 길이는 Ntddndis.h 헤더 파일에 선언됩니다. NDIS_IF_MAX_STRING_SIZE Ifdef.h 헤더 파일에 정의된 IF_MAX_STRING_SIZE 상수로 정의됩니다.
참고
Ntddndis.h 및 Ifdef.h 헤더 파일은 Netioapi.h 헤더 파일에 자동으로 포함됩니다. Ntddndis.h 및 Ifdef.h 헤더 파일을 직접 사용하면 안 됩니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
PASSIVE_LEVEL |