DOT11EXT_ONEX_START 콜백 함수(wlanihv.h)

아티클
05/23/2024

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

IHV 확장 DLL은 Dot11ExtStartOneX 함수를 호출하여 AP(액세스 지점)를 사용하여 802.1X 인증 작업을 시작합니다. 이 경우 인증은 IHV 확장 DLL 대신 Native 802.11 프레임워크의 802.1X 모듈에서 관리됩니다.

구문

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in, optional] pEapAttributes

인증 세션에서 반환된 EAP 특성을 포함하는 EAP_ATTRIBUTES 배열 구조체에 대한 포인터입니다. EAP_ATTRIBUTES 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

반환 값

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

설명

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

IHV 확장 DLL은 Dot11ExtStartOneX 함수를 호출하여 802.1X 인증 작업을 시작합니다. Dot11ExtStartOneX 는 연결 후 작업 중이나 작업이 완료된 후에만 호출할 수 있습니다. 이 작업에 대한 자세한 내용은 연결 후 작업을 참조하세요.

Dot11ExtStartOneX 함수가 호출되면 운영 체제는 EAP over LAN(EAPOL) Start 패킷을 AP에 보냅니다. AP가 EAPOL-Start 패킷을 세 번 전송한 후 응답하지 않으면 운영 체제는 802.1X 인증 작업에 실패하고 를 호출합니다. Dot11ExtIhvOneXIndicateResult IHV 처리기 함수입니다. EAPOL-Start 패킷에 대한 자세한 내용은 IEEE 802.1X-1999 표준의 절 7.5 및 절 8.4.2를 참조하세요.

802.1X 인증 작업이 시작된 후 IHV 확장 DLL은 다음 지침을 따라야 합니다.

IHV 확장은 처리를 위해 모든 EAPOL 패킷을 운영 체제로 전달해야 합니다. DLL이 Dot11ExtIhvReceivePacket IHV 처리기 함수에 대한 호출을 통해 EAPOL 패킷을 수신하는 경우 DLL은 Dot11ExtProcessOneXPacket 을 호출하여 패킷을 운영 체제로 전달해야 합니다.
EAPOL 패킷에 대한 자세한 내용은 IEEE 802.1X-2001 표준의 절 7을 참조하세요.

참고 IHV 확장 DLL은 EAPOL-Key 패킷 처리를 담당하며 이를 운영 체제로 전달해서는 안 됩니다.
802.1X 인증 작업이 완료되면 운영 체제는 다음을 호출합니다. Dot11ExtIhvOneXIndicateResult 권한 부여가 진행 중임을 나타내는 IHV 처리기 함수입니다.
IHV 확장 DLL은 Dot11ExtStopOneX를 호출하여 802.1X 인증 작업을 취소할 수 있습니다.

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

요구 사항

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