Dot11ExtStartOneX (Compact 2013)

  • Article

3/26/2014

The IHV Extensions DLL calls this function to start an 802.1X authentication operation with the access point (AP). In this situation, the authentication is managed by the 802.1X module of the Native 802.11 framework instead of by the IHV Extensions DLL.

Syntax

DWORD WINAPI Dot11ExtStartOneX(
    HANDLE hDot11SvcHandle
    EAP_ATTRIBUTES* pEapAttribute
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is used by the operating system to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.
  • pEapAttribute
    [in] A pointer to an EAP_ATTRIBUTES array structure that contains the EAP attributes returned by the authentication session.

Return Value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

The IHV Extensions DLL can start an 802.1X authentication operation by using the 802.1X module of the Native 802.11 framework. This enables the DLL to use the standard extensible authentication protocol (EAP) algorithms that are supported by the operating system.

The IHV Extensions DLL starts the 802.1X authentication operation by calling the Dot11ExtStartOneX function. Dot11ExtStartOneX can be called only during a post-association operation or after the operation has finished.

When the Dot11ExtStartOneX function is called, the operating system sends an EAP over LAN (EAPOL) Start packet to the AP. If the AP does not respond after three transmissions of the EAPOL-Start packet, the operating system fails the 802.1X authentication operation and calls the Dot11ExtIhvOneXIndicateResult IHV Handler function. For more information about the EAPOL-Start packet, refer to Clause 7.5 and Clause 8.4.2 of the IEEE 802.1X-1999 standard.

After the 802.1X authentication operation is initiated, the IHV Extensions DLL must follow these guidelines.

  • The IHV Extensions must forward all EAPOL packets to the operating system for processing. When the DLL receives an EAPOL packet through a call to the Dot11ExtIhvReceivePacket IHV Handler function, the DLL must call Dot11ExtProcessOneXPacket to forward the packet to the operating system.
    For more information about EAPOL packets, refer to Clause 7 of the IEEE 802.1X-2001 standard.

Note

The IHV Extensions DLL is responsible for processing EAPOL-Key packets and must not forward these to the operating system.

  • When the 802.1X authentication operation is complete, the operating system calls the Dot11ExtIhvOneXIndicateResult IHV Handler function to indicate that authorization is in progress.
  • The IHV Extensions DLL can cancel the 802.1X authentication operation by calling Dot11ExtOneXStop.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
Dot11ExtIhvOneXIndicateResult
Dot11ExtIhvReceivePacket
Dot11ExtProcessOneXPacket
Dot11ExtOneXStop
Native 802.11 IHV Extensions DLL

Other Resources

EAP_ATTRIBUTES