DOT11EXTIHV_PERFORM_POST_ASSOCIATE callback function (wlanihv.h)

Article
02/22/2024

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 Dot11ExtIhvPerformPostAssociate function to request that the IHV Extensions DLL initiate a post-association operation with the basic service set (BSS) network.

Syntax

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

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, optional] hSecuritySessionID

The handle of the security session. The IHV Extensions DLL must use this handle value when it calls Dot11ExtPostAssociateCompletion to asynchronously complete the post-association operation.

[in] pPortState

A pointer to a DOT11_PORT_STATE structure, which specifies the current port state of the security session.

[in] uDot11AssocParamsBytes

The length, in bytes, of the data referenced through the pDot11AssocParams parameter.

[in] pDot11AssocParams

A pointer to a DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure, which specifies the result of the association operation completed by the WLAN adapter. The Native 802.11 miniport driver, which manages the WLAN adapter, includes a DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure when it makes a media-specific NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication.

For more information about the association operation, see Association Operations.

Return value

If the IHV Extension DLL can initiate the post-association operation, it must complete the operation asynchronously. In this situation, the function returns ERROR_SUCCESS.

If the IHV Extensions DLL cannot initiate the post-association operation, it returns an error code defined in Winerror.h.

Remarks

The operating system calls the Dot11ExtIhvPerformPostAssociate function to initiate a post-association operation with the IHV Extensions DLL. The operating system initiates this operation after the WLAN adapter completes an association operation with an access point (AP) in an infrastructure basic service set (BSS) network.

Note For Windows Vista, the IHV Extensions DLL supports only infrastructure basic service set (BSS) networks.

For more information about the association operation, see Association Operations.

The post-association operation must be completed asynchronously from the call to Dot11ExtIhvPerformPostAssociate. After the post-association operation completes, the DLL must call Dot11ExtPostAssociateCompletion.

If the IHV Extensions DLL can initiate the post-association operation, the Dot11ExtIhvPerformPostAssociate function must return ERROR_SUCCESS and complete the operation asynchronously.

For more information about the post-association operation, see Post-Association Operations.

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, Windot11.h, L2cmn.h)