DOT11EXTIHV_STOP_POST_ASSOCIATE callback function (wlanihv.h)

Article
02/22/2024

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.

Syntax

DOT11EXTIHV_STOP_POST_ASSOCIATE Dot11extihvStopPostAssociate;

DWORD Dot11extihvStopPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           PDOT11_MAC_ADDRESS pPeer,
  [in]           DOT11_ASSOC_STATUS dot11AssocStatus
)
{...}

Parameters

[in, optional] hIhvExtAdapter

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.

[in] pPeer

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.

[in] 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 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

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	wlanihv.h (include Wlanihv.h, Windot11.h)