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

Die IHV Extensions DLL ruft die Dot11ExtPreAssociateCompletion--Funktion auf, um asynchron einen über einen Aufruf an den Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

Syntax

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem 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] hConnectSession

Das Handle, das vom Betriebssystem verwendet wird, um auf die Verbindungssitzung mit dem BSS-Netzwerk (Basic Service Set) zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf des Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwReasonCode

Ein Wert, der zusätzliche Informationen für den Abschlussstatus des Vorzuordnungsvorgangs bereitstellt. Die IHV Extensions DLL muss dwReasonCode- auf einen L2_REASON_CODE_xxxx Wert festlegen, der in L2cmn.h definiert ist.

Die IHV Extensions DLL gibt den allgemeinen Abschlussstatus des Vorzuordnungsvorgangs über den dwWin32Error Parameter zurück. In der Regel legt die IHV Extensions DLL dwReasonCode- auf einen Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) fest.

[in] dwWin32Error

Der Abschlussstatus des Vorgangs vor der Zuordnung gemäß der Definition eines Fehlercodes in Winerror.h. Wenn der Vorgang erfolgreich abgeschlossen ist, muss die IHV Extensions DLL dwWin32Error- auf ERROR_SUCCESS festlegen.

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

Die IHV Extensions DLL muss beim Aufrufen der Dot11ExtPreAssociateCompletion-Funktion diese Richtlinien befolgen.

Wenn der Vorzuordnungsvorgang erfolgreich abgeschlossen wurde, muss die IHV-Erweiterungs-DLL dwReasonCode- auf eine der folgenden Werte festlegen:
- L2_REASON_CODE_SUCCESS.
- Ein IHV-definierter Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In diesem Fall muss die IHV Extensions DLL dwWin32Error auf ERROR_SUCCESS festlegen.
Wenn der Vorzuordnungsvorgang mit einem Fehler abgeschlossen wurde, darf die IHV-Erweiterungs-DLL nicht dwReasonCode- auf L2_REASON_CODE_SUCCESS festlegen. Stattdessen muss die DLL dwReasonCode- auf eine der folgenden Festlegen festlegen:
- Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert.
- Ein IHV-definierter Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In diesem Fall darf die IHV Extensions DLL nicht dwWin32Error- auf ERROR_SUCCESS festlegen. Stattdessen muss die DLL dwWin32Error- auf einen geeigneten Fehlercode festlegen, der in Winerror.h definiert ist.
Die IHV-Erweiterungs-DLL muss Dot11ExtPreAssociateCompletion- aufrufen, um alle ausstehenden Vorzuordnungsvorgänge abzubrechen, wenn die Dot11ExtIhvAdapterReset oder Dot11ExtIhvDeinitAdapter IHV-Handlerfunktionen aufgerufen werden. In diesem Fall muss die DLL den parameter dwWin32Error auf ERROR_CANCELLED festlegen.

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)

Siehe auch

Dot11ExtIhvAdapterReset-

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Native 802.11 IHV-Handlerfunktionen

Dot11ExtIhvPerformPreAssociate

Freigeben über