Share via

Dot11ExtIhvPerformPreAssociate (Compact 2013)

  • Article

3/26/2014

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

Syntax

DWORD WINAPI Dot11ExtIhvPerformPreAssociate(
    HANDLE hIhvExtAdapter,
    HANDLE hConnectSession,
    PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
    PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
    PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
    PDOT11_BSS_LIST pConnectableBssid,
    PDWORD pdwReasonCode
);

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.
  • hConnectSession
    [in] The handle that is used by the operating system to reference the connection session with the basic service set (BSS) network.
  • pIhvProfileParams
    [in] A pointer to a DOT11EXT_IHV_PROFILE_PARAMS structure. This structure defines the attributes of the basic service set (BSS) network to which the profile extensions will be applied.
  • pConnectableBssid
    [in] A pointer to a DOT11_BSS_LIST structure. This contains one or more 802.11 Beacon or Probe Response frames for the service set identifier (SSID) of the BSS network with which the DLL will perform the pre-association operation.
  • pwdReasonCode
    [out] A pointer to a DWORD value, which provides additional information for the return value of the Dot11ExtIhvPerformPreAssociate function. The IHV Extensions DLL must set *pdwReasonCode to an L2_REASON_CODE_xxxx value, which are defined in L2cmn.h.

Return Value

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

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

Remarks

The operating system calls the Dot11ExtIhvPerformPreAssociate function to start a pre-association operation with the IHV Extensions DLL. The operating system starts this operation before it starts a connection operation with a basic service set (BSS) network through the WLAN adapter.

The pre-association operation must be completed asynchronously from the call to Dot11ExtIhvPerformPreAssociate. After the pre-association operation is complete, the IHV Extensions DLL must call Dot11ExtPreAssociateCompletion.

When the Dot11ExtIhvPerformPreAssociate function is called, the IHV Extensions DLL must follow these guidelines:

  • If the IHV Extensions DLL can start the pre-association operation, the Dot11ExtIhvPerformPreAssociate function must return ERROR_SUCCESS and complete the operation asynchronously.
  • The IHV Extensions DLL provides more information about the initiation of the pre-association operation through the pdwReasonCode parameter. The DLL must set *pdwReasonCode to one of the following:
    • L2_REASON_CODE_SUCCESS, if the pre-association operation can initiated successfully.
    • An appropriate L2_REASON_CODE_xxxx error value, if the pre-association operation could not be initiated.
    • An IHV-defined value in the range from L2_REASON_CODE_IHV_BASE to (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), regardless of whether the pre-association operation could be initiated or not.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvInitAdapter
DOT11EXT_IHV_PROFILE_PARAMS
DOT11EXT_IHV_CONNECTIVITY_PROFILE
DOT11EXT_IHV_SECURITY_PROFILE
DOT11_BSS_LIST
Dot11ExtPreAssociateCompletion
Native 802.11 IHV Extensions DLL