DOT11EXT_PROCESS_ONEX_PACKET callback function (wlanihv.h)
Syntax
DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;
DWORD Dot11extProcessOnexPacket(
[in, optional] HANDLE hDot11SvcHandle,
[in] DWORD dwInPacketSize,
[in] LPVOID pvInPacket
)
{...}
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] dwInPacketSize
The length, in bytes, of the packet data within the buffer that is referenced by the pvInPacket parameter.
[in] pvInPacket
The EAPOL packet received from the AP. The pvInPacket parameter must reference the EAPOL packet starting from the packet type field in the EAPOL protocol data unit (PDU). For more information about the EAPOL packet type field, refer to Clause 7.5.4 in the IEEE 802.1X-2001 standard.
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 initiates 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.
While the 802.1X authentication operation is pending, the IHV Extensions DLL forwards received EAP over LAN (EAPOL) packets to the operating system through a call to the Dot11ExtProcessOneXPacket function. The IHV Extensions DLL receives these packets through the Dot11ExtIhvReceivePacket IHV Handler function.
For more information about using the 802.1X module for authentication, see Interface to the Native 802.11 802.1X Module
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) |