Dot11ExtIhvPerformPostAssociate (Compact 2013)

3/26/2014

The operating system calls this function to request that the IHV Extensions DLL start a post-association operation with the basic service set (BSS) network.

Syntax

DWORD WINAPI Dot11ExtIhvPerformPostAssociate(
    HANDLE hIhvExtAdapter,
    HANDLE hSecuritySessionID,
    PDOT11_PORT_STATE pPortState,
    ULONG uDot11AssocParamsBytes,
    PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
);

Parameters

• hIhvExtAdapter
  [in] The handle that is used by the IHV Extensions DLL to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

• hSecuritySessionID
  [in] 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.

Return Value

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

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

Remarks

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

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

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

Requirements

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvInitAdapter
Dot11ExtPostAssociateCompletion
DOT11_PORT_STATE
DOT11_ASSOCIATION_COMPLETION_PARAMETERS
NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION
Dot11ExtIhvAdapterReset
Native 802.11 IHV Extensions DLL