DOT11EXT_POST_ASSOCIATE_COMPLETION Rückruffunktion (wlanihv.h)

Artikel
08/08/2023

Wichtig 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-Treibermodell.

Die IHV-Erweiterungen-DLL ruft die Dot11ExtPostAssociateCompletion-Funktion auf, um einen über einen Aufruf des initiierten Vorgangs nach der Zuordnung asynchron abzuschließen. Dot11ExtIhvPerformPostAssociate IHV-Handlerfunktion.

Syntax

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [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 Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in, optional] hSecuritySessionID

Das Handle der Sicherheitssitzungs-ID, die über einen vorherigen Aufruf des zurückgegeben wurde Dot11ExtIhvPerformPostAssociate IHV-Handlerfunktion.

[in, optional] pPeer

Die MAC-Adresse (Media Access Control) des Zugriffspunkts (Access Point, AP), mit dem die IHV-Erweiterungen-DLL einen Sicherheitsvorgang ausgeführt hat. Dieser Parameter ist als DOT11_MAC_ADDRESS-Struktur formatiert.

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

[in] dwReasonCode

Ein Wert, der zusätzliche Informationen für die Vervollständigung status des Vorgangs nach 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 die allgemeine Vervollständigung status des Vorgangs nach der Zuordnung über den dwWin32Error-Parameter zurück. In der Regel legt die DLL für IHV-Erweiterungen dwReasonCode auf einen Wert innerhalb des Bereichs von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) fest.

[in] dwWin32Error

Die Vervollständigung status des Vorgangs nach der Zuordnung, wie durch einen Fehlercode in Winerror.h definiert. Wenn der Vorgang erfolgreich abgeschlossen wurde, muss die IHV-Erweiterungen-DLL 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 ruft die Dot11ExtPostAssociateCompletion-Funktion auf, um eine der folgenden Aktionen auszuführen:

Schließen Sie den Vorgang nach der Zuordnung ab, der durch einen Aufruf des Dot11ExtIhvPerformPostAssociate IHV-Handlerfunktion.
Geben Sie nach Abschluss des Vorgangs nach der Zuordnung eine Änderung des Portstatus für die Sicherheitssitzung an, auf die vom Parameter hSecuritySessionID verwiesen wird.
Wenn sich beispielsweise der Autorisierungsstatus des Ports ändert, kann die IHV-Erweiterungen-DLL das Betriebssystem benachrichtigen, indem Sie Dot11ExtPostAssociateCompletion aufrufen.

Die DLL für IHV-Erweiterungen muss diese Richtlinien befolgen, wenn die Funktion Dot11ExtPostAssociateCompletion aufgerufen wird.

Wenn der Vorgang nach 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 dieser Situation muss die DLL für IHV-Erweiterungen dwWin32Error auf ERROR_SUCCESS festlegen.
Hinweis Wenn die DLL für IHV-Erweiterungen dwWin32Error auf ERROR_SUCCESS festlegt, geht das Betriebssystem davon aus, dass der Portstatus für die Sicherheitssitzung autorisiert ist. Nachdem sich der Port in einem autorisierten Zustand befindet, ermöglicht das Betriebssystem, dass alle Datenpakete über den WLAN-Adapter gesendet werden.
Wenn der Vorgang nach der Zuordnung mit einem Fehler abgeschlossen wurde, darf die IHV-Erweiterungen-DLL 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 dieser Situation darf die IHV-Erweiterungen-DLL dwWin32Error nicht auf ERROR_SUCCESS festlegen. Stattdessen muss die DLL dwWin32Error auf einen entsprechenden Fehlercode festlegen, der in Winerror.h definiert ist.
Hinweis Wenn die DLL für IHV-Erweiterungen dwWin32Error nicht auf ERROR_SUCCESS festgelegt hat, geht das Betriebssystem davon aus, dass sich der Portzustand für die Sicherheitssitzung in einem nicht autorisierten Zustand befindet. Nachdem sich der Port in einem nicht autorisierten Zustand befindet, ermöglicht das Betriebssystem das Senden von Sicherheitspaketen, einschließlich Paketen, die über die Funktion Dot11ExtSendPacket IHV Extensions gesendet werden, über den WLAN-Adapter.
Die IHV-Erweiterungen-DLL muss Dot11ExtPostAssociateCompletion aufrufen, um alle ausstehenden Vorgänge nach der Zuordnung abzubrechen, wenn die IHV-Handlerfunktionen Dot11ExtIhvAdapterReset oder Dot11ExtIhvDeinitAdapter aufgerufen werden. In dieser Situation muss die DLL den dwStatus-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 (include Wlanihv.h)