Dot11ExtOneXStop (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this function to cancel an 802.1X authentication operation with the access point (AP). The DLL initiated the authentication through a call to the Dot11ExtStartOneX function.

Syntax

DWORD WINAPI Dot11ExtOneXStop(
    HANDLE  hDot11SvcHandle
);

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.

Return Value

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

Remarks

When it calls the Dot11ExtStartOneX function, the IHV Extensions DLL starts 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.

Before the 802.1X authentication operation is complete, the IHV Extensions DLL can call the Dot11ExtOneXStop function to cancel the operation.

When it calls the Dot11ExtOneXStop function, the IHV Extensions DLL must follow these guidelines.

  • Dot11ExtOneXStop can be called only while an 802.1X authentication operation is pending. The IHV Extensions DLL starts the authentication with the AP by calling Dot11ExtStartOneX. When the 802.1X authentication operation is complete, the operating system calls the Dot11ExtIhvOneXIndicateResult IHV Handler function.
  • After the IHV Extensions DLL calls Dot11ExtOneXStop, it must not call Dot11ExtProcessOneXPacket to forward 802.1X EAP over LAN (EAPOL) packets to the operating system. For more information about EAPOL packets, refer to Clause 7 of the IEEE 802.1X-2001 standard.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtStartOneX
Dot11ExtIhvInitAdapter
Dot11ExtIhvOneXIndicateResult
Dot11ExtProcessOneXPacket
Native 802.11 IHV Extensions DLL