DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Rückruffunktion (wlanihv.h)

2025-02-07

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

Syntax

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

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] hConnectSession

Das Handle, das vom Betriebssystem verwendet wird, um auf die Verbindungssitzung mit dem BSS-Netzwerk (Basic Service Set) zu verweisen.

[in, optional] pIhvProfileParams

Ein Zeiger auf ein DOT11EXT_IHV_PROFILE_PARAMS Struktur. Diese Struktur definiert die Attribute des BSS-Netzwerks (Basic Service Set), auf das die Profilerweiterungen angewendet werden.

[in] pIhvConnProfile

Ein Zeiger auf ein DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Verbindungseinstellungen für das IHV-Profil enthält.

[in] pIhvSecProfile

Ein Zeiger auf ein DOT11EXT_IHV_SECURITY_PROFILE Struktur, die Sicherheitseinstellungen für das IHV-Profil angibt.

[in] pConnectableBssid

Ein Zeiger auf eine DOT11_BSS_LIST-Struktur, die einen oder mehrere 802.11 Beacon- oder Probeantwortframes für den Dienstsatzbezeichner (SSID) des BSS-Netzwerks enthält, mit dem die DLL den Vorzuordnungsvorgang ausführt.

[out] pdwReasonCode

Ein Zeiger auf einen DWORD-Wert, der zusätzliche Informationen für den Rückgabewert der Dot11ExtIhvPerformPreAssociate-Funktion bereitstellt. Die IHV Extensions DLL muss * pdwReasonCode auf einen L2_REASON_CODE_xxxx Wert festlegen, der in L2cmn.h definiert ist.

Rückgabewert

Wenn die IHV-Erweiterungs-DLL den Vorzuordnungsvorgang 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 vor der Zuordnung nicht initiieren kann, wird ein Fehlercode zurückgegeben, der in Winerror.hdefiniert ist.

Bemerkungen

Das Betriebssystem ruft die Dot11ExtIhvPerformPreAssociate-Funktion auf, um einen Vorabzuordnungsvorgang mit der IHV Extensions DLL zu initiieren. Das Betriebssystem initiiert diesen Vorgang, bevor er einen Verbindungsvorgang mit einem BSS-Netzwerk (Basic Service Set) über den WLAN-Adapter initiiert. Weitere Informationen zum Verbindungsvorgang finden Sie unter Verbindungsvorgänge.

Der Vorzuordnungsvorgang muss asynchron vom Aufruf von Dot11ExtIhvPerformPreAssociateabgeschlossen werden. Nach Abschluss des Vorzuordnungsvorgangs muss die IHV-Erweiterungs-DLL aufrufen Dot11ExtPreAssociateCompletion.

Wenn die Dot11ExtIhvPerformPreAssociate Funktion aufgerufen wird, muss die IHV Extensions DLL diese Richtlinien befolgen.

Wenn die IHV-Erweiterungs-DLL den Vorzuordnungsvorgang initiieren kann, muss die Dot11ExtIhvPerformPreAssociate--Funktion ERROR_SUCCESS zurückgeben und den Vorgang asynchron abschließen.
Die IHV Extensions DLL enthält weitere Informationen zur Initiierung des Vorabzuordnungsvorgangs über den pdwReasonCode Parameter. Die DLL muss * pdwReasonCode- auf eine der folgenden Festlegen festlegen:
- L2_REASON_CODE_SUCCESS, wenn der Vorgang vor der Zuordnung erfolgreich initiiert werden kann.
- Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert, wenn der Vorgang vor der Zuordnung nicht initiiert werden konnte.
- Ein IHV-definierter Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), unabhängig davon, ob der Vorzuordnungsvorgang initiiert werden kann oder nicht.

Weitere Informationen zum Vorzuordnungsvorgang finden Sie unter Pre-Association Operation.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Desktop
Header-	wlanihv.h (include Wlanihv.h, L2cmn.h)