DOT11EXTIHV_PERFORM_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 Dot11ExtIhvPerformPostAssociate-Funktion auf, um anzufordern, dass die IHV Extensions DLL einen Postzuordnungsvorgang mit dem BSS-Netzwerk (Basic Service Set) initiiert.

Syntax

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

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, optional] hSecuritySessionID

Das Handle der Sicherheitssitzung. Die IHV-Erweiterungs-DLL muss diesen Handlewert verwenden, wenn er aufruft Dot11ExtPostAssociateCompletion, um den Vorgang nach der Zuordnung asynchron abzuschließen.

[in] pPortState

Ein Zeiger auf eine DOT11_PORT_STATE-Struktur, die den aktuellen Portstatus der Sicherheitssitzung angibt.

[in] uDot11AssocParamsBytes

Die Länge der daten, auf die durch den pDot11AssocParams Parameter verwiesen wird.

[in] pDot11AssocParams

Ein Zeiger auf ein DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur, die das Ergebnis des Zuordnungsvorgangs angibt, der vom WLAN-Adapter abgeschlossen wurde. Der Native 802.11-Miniporttreiber, der den WLAN-Adapter verwaltet, enthält eine DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur, wenn er einen medienspezifischen NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Indikation.

Weitere Informationen zum Zuordnungsvorgang finden Sie unter Zuordnungsvorgänge.

Rückgabewert

Wenn die IHV-Erweiterungs-DLL den Vorgang nach der Zuordnung initiieren kann, muss sie den Vorgang asynchron abschließen. In dieser Situation gibt die Funktion ERROR_SUCCESS zurück.

Wenn die IHV Extensions DLL den Vorgang nach der Zuordnung nicht initiieren kann, wird ein fehlercode zurückgegeben, der in Winerror.hdefiniert ist.

Bemerkungen

Das Betriebssystem ruft die Dot11ExtIhvPerformPostAssociate-Funktion auf, um einen Vorgang nach der Zuordnung mit der IHV Extensions DLL zu initiieren. Das Betriebssystem initiiert diesen Vorgang, nachdem der WLAN-Adapter einen Zuordnungsvorgang mit einem Zugriffspunkt (AP) in einem BSS-Netzwerk (Infrastructure Basic Service Set) abgeschlossen hat.

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

Weitere Informationen zum Zuordnungsvorgang finden Sie unter Zuordnungsvorgänge.

Der Vorgang nach der Zuordnung muss asynchron vom Aufruf von Dot11ExtIhvPerformPostAssociateabgeschlossen werden. Nach Abschluss des Zuordnungsvorgangs muss die DLL aufrufen Dot11ExtPostAssociateCompletion.

Wenn die IHV-Erweiterungs-DLL den Vorgang nach der Zuordnung initiieren kann, muss die Dot11ExtIhvPerformPostAssociate-Funktion ERROR_SUCCESS zurückgeben und den Vorgang asynchron abschließen.

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 (einschließlich Wlanihv.h, Windot11.h, L2cmn.h)

Siehe auch

Dot11ExtPostAssociateCompletion-

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset-

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION

Freigeben über