DOT11EXTIHV_PERFORM_POST_ASSOCIATE Rückruffunktion (wlanihv.h)

Artikel
08/08/2023

Wichtig Die native WLAN-Schnittstelle 802.11 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-Erweiterungs-DLL einen Vorgang nach der Zuordnung 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 DLL für IHV-Erweiterungen verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in, optional] hSecuritySessionID

Das Handle der Sicherheitssitzung. Die DLL für IHV-Erweiterungen muss diesen Handle-Wert verwenden, wenn sie 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 in Bytes, auf die durch den Parameter pDot11AssocParams verwiesen wird.

[in] pDot11AssocParams

Ein Zeiger auf eine DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur , die das Ergebnis des vom WLAN-Adapter abgeschlossenen Zuordnungsvorgangs angibt. 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 Hinweis.

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 diesem Fall gibt die Funktion ERROR_SUCCESS zurück.

Wenn die DLL für IHV-Erweiterungen den Vorgang nach der Zuordnung nicht initiieren kann, gibt sie einen in Winerror.h definierten Fehlercode zurück.

Hinweise

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

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

Weitere Informationen zum Zuordnungsvorgang finden Sie unter Zuordnungsvorgänge.

Der Vorgang nach der Zuordnung muss über den Aufruf von Dot11ExtIhvPerformPostAssociate asynchron abgeschlossen werden. Nach Abschluss des Vorgangs nach der Zuordnung muss die DLL aufrufen. Dot11ExtPostAssociateCompletion.

Wenn die DLL für IHV-Erweiterungen 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 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 (einschließlich Wlanihv.h, Windot11.h, L2cmn.h)