DOT11EXT_PROCESS_ONEX_PACKET 콜백 함수(wlanihv.h)

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

 

IHV 확장 DLL은 Dot11ExtProcessOneXPacket 함수를 호출하여 AP(액세스 지점)를 사용하여 802.1X 인증 작업 중에 처리를 위해 EAPOL(EAP over LAN) 패킷을 운영 체제로 전달합니다.

구문

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

운영 체제에서 WLAN(무선 LAN) 어댑터를 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 지정되었습니다.

[in] dwInPacketSize

pvInPacket 매개 변수에서 참조하는 버퍼 내의 패킷 데이터의 길이(바이트)입니다.

[in] pvInPacket

AP에서 받은 EAPOL 패킷입니다. pvInPacket 매개 변수는 EAPOL PDU(프로토콜 데이터 단위)의 패킷 유형 필드에서 시작하는 EAPOL 패킷을 참조해야 합니다. EAPOL 패킷 유형 필드에 대한 자세한 내용은 IEEE 802.1X-2001 표준의 절 7.5.4를 참조하세요.

반환 값

호출이 성공하면 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

Dot11ExtStartOneX 함수를 호출하면 IHV 확장 DLL은 Native 802.11 프레임워크의 802.1X 모듈을 사용하여 802.1X 인증 작업을 시작합니다. 이를 통해 DLL은 운영 체제에서 지원하는 표준 EAP(확장 가능 인증 프로토콜) 알고리즘을 사용할 수 있습니다.

802.1X 인증 작업이 보류 중인 동안 IHV 확장 DLL은 Dot11ExtProcessOneXPacket 함수를 호출하여 EAP over LAN(EAPOL) 패킷을 운영 체제에 전달합니다. IHV 확장 DLL은 Dot11ExtIhvReceivePacket IHV 처리기 함수를 통해 이러한 패킷을 수신합니다.

참고 IHV 확장 DLL은 EAPOL-Key 패킷 처리를 담당하며 운영 체제에 전달해서는 안 됩니다.

 

EAPOL 패킷에 대한 자세한 내용은 IEEE 802.1X-2001 표준의 절 7을 참조하세요.

인증에 802.1X 모듈을 사용하는 방법에 대한 자세한 내용은 네이티브 802.11 802.1X 모듈에 대한 인터페이스를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	wlanihv.h(Wlanihv.h 포함)

추가 정보

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX