DOT11EXT_PRE_ASSOCIATE_COMPLETION Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

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.

Die DLL für IHV-Erweiterungen ruft die Dot11ExtPreAssociateCompletion-Funktion auf, um einen Vorabzuordnungsvorgang asynchron abzuschließen, der über einen Aufruf von initiiert wird. 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 durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter 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 Handle-Wert wurde durch einen vorherigen Aufruf von angegeben. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwReasonCode

Ein -Wert, der zusätzliche Informationen zum Abschluss status des Vorgangs vor der Zuordnung bereitstellt. Die DLL für IHV-Erweiterungen muss dwReasonCode auf einen L2_REASON_CODE_xxxx-Wert festlegen, der in L2cmn.h definiert ist.

Die DLL für IHV-Erweiterungen gibt den allgemeinen Abschluss status des Vorgangs vor der Zuordnung über den dwWin32Error-Parameter zurück. In der Regel legt die DLL für IHV-Erweiterungen 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 Abschluss status des Vorgangs vor der Zuordnung, wie durch einen Fehlercode in Winerror.h definiert. Wenn der Vorgang erfolgreich abgeschlossen wird, muss die DLL für IHV-Erweiterungen dwWin32Error auf ERROR_SUCCESS festlegen.

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

Die DLL für IHV-Erweiterungen muss beim Aufrufen der Dot11ExtPreAssociateCompletion-Funktion diese Richtlinien befolgen.

Wenn der Vorgang vor der Zuordnung erfolgreich abgeschlossen wurde, muss die DLL für IHV-Erweiterungen dwReasonCode auf eine der folgenden Optionen 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 DLL für IHV-Erweiterungen dwWin32Error auf ERROR_SUCCESS festlegen.
Wenn der Vorzuordnungsvorgang mit einem Fehler abgeschlossen wurde, darf die DLL für IHV-Erweiterungen dwReasonCode nicht auf L2_REASON_CODE_SUCCESS festlegen. Stattdessen muss die DLL dwReasonCode auf eine der folgenden 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 DLL für IHV-Erweiterungen dwWin32Error nicht auf ERROR_SUCCESS festlegen. Stattdessen muss die DLL dwWin32Error auf einen geeigneten Fehlercode festlegen, der in Winerror.h definiert ist.
Die DLL für IHV-Erweiterungen muss Dot11ExtPreAssociateCompletion aufrufen, um alle ausstehenden Vorgänge vor der Zuordnung abzubrechen, wenn die IHV-Handlerfunktionen Dot11ExtIhvAdapterReset oder Dot11ExtIhvDeinitAdapter aufgerufen werden. In diesem Fall muss die DLL den dwWin32Error-Parameter auf ERROR_CANCELLED festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)

Weitere Informationen

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Native 802.11 IHV-Handlerfunktionen

Dot11ExtIhvPerformPreAssociate

Freigeben über