DOT11EXTIHV_STOP_POST_ASSOCIATE Rückruffunktion (wlanihv.h)

Artikel
02/07/2025

Wichtige 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 driver model.

Das Betriebssystem ruft die Dot11ExtIhvStopPostAssociate-Funktion auf, um den postzuordnungsvorgang abzubrechen, der über 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 IHV Extensions DLL verwendet wird, um auf den Wlan-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.

[in] pPeer

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

Hinweis Für Windows Vista unterstützt die IHV-Erweiterungs-DLL nur Infrastruktur-Basisdienste (BSS)-Netzwerke.

[in] dot11AssocStatus

Ein DOT11_ASSOC_STATUS Typ, der den Zuordnungsstatus der Station 802.11 für das Netzwerk angibt.

Rückgabewert

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

Bemerkungen

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

Der WLAN-Adapter schließt einen Nichtzuordnungsvorgang mit der AP ab. In dieser Situation macht der Native 802.11-Miniporttreiber, der den Adapter verwaltet, einen medienspezifischen NDIS_STATUS_DOT11_DISASSOCIATION Indikation. Weitere Informationen zum Zuordnungsvorgang finden Sie unter Disassociation Operations.
Der WLAN-Adapter ist deaktiviert oder entfernt. In dieser Situation ruft das Betriebssystem die Dot11ExtIhvStopPostAssociate-Funktion auf, bevor die Funktion aufgerufen wird. Dot11ExtIhvDeinitAdapter Funktion.

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

Weitere Informationen zum Vorgang nach der Zuordnung finden Sie unter Post-Association Operations.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h, Windot11.h)

Siehe auch

DOT11_ASSOC_STATUS

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

NDIS_STATUS_DOT11_DISASSOCIATION Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS

Freigeben über