DOT11EXT_ONEX_START callback function (wlanihv.h)
Syntax
DOT11EXT_ONEX_START Dot11extOnexStart;
DWORD Dot11extOnexStart(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}
Parameters
[in, optional] hDot11SvcHandle
The handle 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.
[in, optional] pEapAttributes
A pointer to an EAP_ATTRIBUTES array structure that contains the EAP attributes returned by the authentication session. For more information about EAP_ATTRIBUTES, see the Microsoft Windows SDK documentation.
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 initiate an 802.1X authentication operation by using the 802.1X module of the Native 802.11 framework. This allows the DLL to use the standard extensible authentication protocol (EAP) algorithms that are supported by the operating system.
The IHV Extensions DLL initiates the 802.1X authentication operation by calling the Dot11ExtStartOneX function. Dot11ExtStartOneX can only be called either during a post-association operation or after the operation has completed. For more information about this operation, see Post-Association Operations.
When the Dot11ExtStartOneX function is called, the operating system sends an EAP over LAN (EAPOL) Start packet to the AP. If the AP fails to 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 completed, 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 Dot11ExtStopOneX.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Target Platform | Desktop |
| Header | wlanihv.h (include Wlanihv.h) |