DOT11EXTIHV_STOP_POST_ASSOCIATE callback

Description

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

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

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.

Prototype

DOT11EXTIHV_STOP_POST_ASSOCIATE Dot11ExtIhvStopPostAssociate;

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

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.

See also

DOT11_ASSOC_STATUS

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

NDIS_STATUS_DOT11_DISASSOCIATION

Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS