Dot11ExtIhvStopPostAssociate (Compact 2013)

  • Article

3/26/2014

The operating system calls this function to cancel the post-association operation that was initiated through a call to the Dot11ExtIhvPerformPostAssociate IHV Handler function.

Syntax

DWORD WINAPI Dot11ExtIhvStopPostAssociate(
    HANDLE hIhvExtAdapter,
    PDOT11_MAC_ADDRESS pPeer,
    DOT11_ASSOC_STATUS dot11AssocStatus
);

Parameters

  • hIhvExtAdapter
    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.
  • pPeer
    A pointer to a DOT11_MAC_ADDRESS structure. This contains the media access control (MAC) of the access point (AP) with which the IHV Extensions DLL initiated a post-association operation.
  • dot11AssocStatus
    A DOT11_ASSOC_STATUS type that specifies the association status of the 802.11 station to the network.

Return Value

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

Remarks

The operating system calls the Dot11ExtIhvStopPostAssociate function to cancel the post-association operation whenever one of the following occurs:

  • The WLAN adapter finishes a disassociation operation with the AP. In this situation, the Native 802.11 miniport driver. This manages the adapter, makes a media-specific NDIS_STATUS_DOT11_DISASSOCIATION indication.
  • The WLAN adapter is disabled or removed. In this situation, the operating system calls the Dot11ExtIhvStopPostAssociate function before it calls the Dot11ExtIhvDeinitAdapter function.

The operating system calls the Dot11ExtIhvStopPostAssociate function to notify the IHV Extensions DLL that the data port created for the association is down. The operating system calls this function regardless of whether the DLL has completed the post-association operation through a call to Dot11ExtPostAssociateCompletion.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvPerformPostAssociate
Dot11ExtIhvInitAdapter
DOT11_ASSOC_STATUS
NDIS_STATUS_DOT11_DISASSOCIATION
Dot11ExtIhvDeinitAdapter
Dot11ExtPostAssociateCompletion
Native 802.11 IHV Extensions DLL

Other Resources

DOT11_MAC_ADDRESS