Dot11ExtPreAssociateCompletion (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this function to asynchronously complete a pre-association operation that was initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.

Syntax

DWORD WINAPI Dot11ExtPreAssociateCompletion(
    HANDLE  hDot11SvcHandle,
    HANDLE  hConnectSession,
    DWORD  dwReasonCode,
    DWORD  dwWin32Error
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is used by the operating system to reference the wireless LAN (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. This handle value was specified through a previous call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.
  • dwReasonCode
    [in] A value that provides additional information for the completion status of the post-association operation. The IHV Extensions DLL must set dwReasonCode to an L2_REASON_CODE_xxxx value, which are defined in L2cmn.h.

    The IHV Extensions DLL returns the general completion status of the post-association operation through the dwWin32Error parameter. Typically, the IHV Extensions DLL sets dwReasonCode to a value within the range from L2_REASON_CODE_IHV_BASE to (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

  • dwWin32Error
    [in] The completion status of the post-association operation as defined by an error code within Winerror.h. If the operation completes successfully, the IHV Extensions DLL must set dwWin32Error to ERROR_SUCCESS.

Return Value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

IHV Extensions DLL must follow these guidelines when it calls the Dot11ExtPreAssociateCompletion function:

  • If the pre-association operation completed successfully, the IHV Extensions DLL must set dwReasonCode to one of the following:
    • L2_REASON_CODE_SUCCESS
    • 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)
      In this situation, the IHV Extensions DLL must set dwWin32Error to ERROR_SUCCESS.
  • If the pre-association operation completed with a failure, the IHV Extensions DLL must not set dwReasonCode to L2_REASON_CODE_SUCCESS. Instead, the DLL must set dwReasonCode to one of the following:
    • An appropriate L2_REASON_CODE_xxxx error value
    • 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)
      In this situation, the IHV Extensions DLL must not set dwWin32Error to ERROR_SUCCESS. Instead, the DLL must set dwWin32Error to an appropriate error code defined in Winerror.h
  • The IHV Extensions DLL must call Dot11ExtPreAssociateCompletion to cancel all pending pre-association operations whenever the Dot11ExtIhvAdapterReset or Dot11ExtIhvDeinitAdapter IHV Handler functions are called. In this situation, the DLL must set the dwWin32Error parameter to ERROR_CANCELLED.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvPerformPreAssociate
Dot11ExtIhvInitAdapter
Dot11ExtPreAssociateCompletion
Dot11ExtIhvAdapterReset
Dot11ExtIhvDeinitAdapter
Native 802.11 IHV Handler Functions
Native 802.11 IHV Extensions DLL