DOT11EXTIHV_STOP_POST_ASSOCIATE Rückruffunktion (wlanihv.h)

Artikel
08/08/2023

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.

Das Betriebssystem ruft die Dot11ExtIhvStopPostAssociate-Funktion auf, um den nach der Zuordnung initiierten Vorgang abzubrechen, der durch einen Aufruf des Dot11ExtIhvPerformPostAssociate IHV-Handlerfunktion.

Syntax

DOT11EXTIHV_STOP_POST_ASSOCIATE Dot11extihvStopPostAssociate;

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

Parameter

[in, optional] hIhvExtAdapter

Das Handle, das von der DLL für IHV-Erweiterungen verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] pPeer

Ein Zeiger auf eine DOT11_MAC_ADDRESS-Struktur , die die Medienzugriffssteuerung (MAC) des Zugriffspunkts (AP) enthält, mit dem die IHV-Erweiterungen-DLL einen Vorgang nach der Zuordnung initiiert hat.

Hinweis Für Windows Vista unterstützt die IHV-Erweiterungen-DLL nur BSS-Netzwerke (Infrastructure Basic Service Set).

[in] dot11AssocStatus

Ein DOT11_ASSOC_STATUS Typ, der die Zuordnung status der 802.11-Station zum Netzwerk angibt.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Das Betriebssystem ruft die Dot11ExtIhvStopPostAssociate-Funktion auf, um den Vorgang nach der Zuordnung abzubrechen, wenn einer der folgenden Ereignisse auftritt.

Der WLAN-Adapter schließt einen Vorgang zum Aufheben der Zuordnung zum AP ab. In dieser Situation erstellt der Native 802.11-Miniporttreiber, der den Adapter verwaltet, einen medienspezifischen NDIS_STATUS_DOT11_DISASSOCIATION Indikation. Weitere Informationen zum Vorgang zum Aufheben der Zuordnung finden Sie unter Trennen von Zuordnungsvorgängen.
Der WLAN-Adapter ist deaktiviert oder entfernt. In dieser Situation ruft das Betriebssystem die Dot11ExtIhvStopPostAssociate-Funktion auf, bevor es die Dot11ExtIhvDeinitAdapter-Funktion .

Das Betriebssystem ruft die Dot11ExtIhvStopPostAssociate-Funktion auf, um die IHV-Erweiterungen-DLL zu benachrichtigen, dass der für die Zuordnung erstellte Datenport ausgefallen ist. Das Betriebssystem ruft diese Funktion auf, unabhängig davon, ob die DLL den Vorgang nach der Zuordnung über einen Aufruf von abgeschlossen hat. Dot11ExtPostAssociateCompletion.

Weitere Informationen zum Vorgang nach der Zuordnung finden Sie unter Vorgänge nach der Zuordnung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (include Wlanihv.h, Windot11.h)

Weitere Informationen

DOT11_ASSOC_STATUS

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

NDIS_STATUS_DOT11_DISASSOCIATION Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS

Freigeben über