Dot11ExtIhvStopPostAssociate routine

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

Syntax


DOT11EXTIHV_STOP_POST_ASSOCIATE Dot11ExtIhvStopPostAssociate;

DWORD APIENTRY Dot11ExtIhvStopPostAssociate(
  _In_opt_  HANDLE hIhvExtAdapter,
  _In_      PDOT11_MAC_ADDRESS pPeer,
  _In_      DOT11_ASSOC_STATUS dot11AssocStatus
)
{ ... }

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.

pPeer [in]

A pointer to a DOT11_MAC_ADDRESS structure, which contains the media access control (MAC) of the access point (AP) with which the IHV Extensions DLL initiated a post-association operation.

Note  For Windows Vista, the IHV Extensions DLL supports only infrastructure basic service set (BSS) networks.

dot11AssocStatus [in]

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 completes a disassociation operation with the AP. In this situation, the Native 802.11 miniport driver, which manages the adapter, makes a media-specific NDIS_STATUS_DOT11_DISASSOCIATION indication. For more information about the disassociation operation, see Disassociation Operations.

  • 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.

For more information about the post-association operation, see Post-Association Operations.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Wlanihv.h (include Wlanihv.h or Windot11.h)

See also

DOT11_ASSOC_STATUS
DOT11_MAC_ADDRESS
NDIS_STATUS_DOT11_DISASSOCIATION
Dot11ExtIhvDeinitAdapter
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPostAssociate

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft