DOT11EXTIHV_PERFORM_POST_ASSOCIATE callback

Description

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.

Parameters

hIhvExtAdapter [in, optional]

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.

hSecuritySessionID [in, optional]

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.

pPortState [in]

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

uDot11AssocParamsBytes [in]

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

pDot11AssocParams [in]

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.

Prototype

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11ExtIhvPerformPostAssociate;

DWORD APIENTRY Dot11ExtIhvPerformPostAssociate(
  _In_opt_ HANDLE                                   hIhvExtAdapter,
  _In_opt_ HANDLE                                   hSecuritySessionID,
  _In_     PDOT11_PORT_STATE                        pPortState,
  _In_     ULONG                                    uDot11AssocParamsBytes,
  _In_     PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{ ... }

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.

See also

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION