DOT11EXTIHV_STOP_POST_ASSOCIATE callback function (wlanihv.h)

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.

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

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

Requirements

See also

DOT11_ASSOC_STATUS

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

DOT11_MAC_ADDRESS