DOT11EXTIHV_ONEX_INDICATE_RESULT callback function (wlanihv.h)

Article
10/21/2021

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

The operating system calls the Dot11ExtIhvOneXIndicateResult IHV Handler function when it completes an 802.1X authentication operation with the access point (AP).

Syntax

DOT11EXTIHV_ONEX_INDICATE_RESULT Dot11extihvOnexIndicateResult;

DWORD Dot11extihvOnexIndicateResult(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11_MSONEX_RESULT msOneXResult,
  [in, optional] PDOT11_MSONEX_RESULT_PARAMS pDot11MsOneXResultParams
)
{...}

Parameters

[in, optional] hIhvExtAdapter

The handle used by the IHV Extensions DLL to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

[in] msOneXResult

The result of the 802.1X authentication operation specified through a DOT11_MSONEX_RESULT enumeration value.

[in, optional] pDot11MsOneXResultParams

A pointer to a DOT11_MSONEX_RESULT_PARAMS structure that contains result parameters.

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 make use of 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.

After the operating system has completed the 802.1X authentication operation, it calls the Dot11ExtIhvOneXIndicateResult 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)