Dot11ExtProcessOneXPacket (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this function to forward EAP over LAN (EAPOL) packets to the operating system for processing during an 802.1X authentication operation with the access point (AP).

Syntax

DWORD WINAPI Dot11ExtProcessOneXPacket(
    HANDLE  hDot11SvcHandle,
    DWORD  dwInPacketSize,
    LPVOID  pvInPacket
);

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.

• dwInPacketSize
  [in] The length, in bytes, of the packet data within the buffer that is referenced by the pvInPacket parameter.

• pvInPacket
  [in] The EAPOL packet that is 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 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.

As long as 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 EAPOL packets, refer to Clause 7 of the IEEE 802.1X-2001 standard.

Requirements

See Also

Reference

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