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

Das Betriebssystem ruft die Dot11ExtIhvPerformPreAssociate-Funktion auf, um anzufordern, dass die IHV-Erweiterungs-DLL einen Vorzuordnungsvorgang 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 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] 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 eine 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 eine DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Konnektivitätseinstellungen für das IHV-Profil enthält.

[in] pIhvSecProfile

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

[in] pConnectableBssid

Ein Zeiger auf eine DOT11_BSS_LIST-Struktur , die ein oder mehrere 802.11 Beacon- oder Testantwortframes 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 DLL für IHV-Erweiterungen 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 diesem Fall gibt die Funktion ERROR_SUCCESS zurück.

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

Hinweise

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

Der Vorgang vor der Zuordnung muss asynchron über den Aufruf von Dot11ExtIhvPerformPreAssociate abgeschlossen werden. Nach Abschluss des Vorzuordnungsvorgangs muss die DLL für IHV-Erweiterungen aufrufen. Dot11ExtPreAssociateCompletion.

Wenn die Dot11ExtIhvPerformPreAssociate-Funktion aufgerufen wird, muss die DLL für IHV-Erweiterungen diese Richtlinien befolgen.

Wenn die DLL für IHV-Erweiterungen den Vorzuordnungsvorgang initiieren kann, muss die Dot11ExtIhvPerformPreAssociate-Funktion ERROR_SUCCESS zurückgeben und den Vorgang asynchron abschließen.
Die DLL für IHV-Erweiterungen bietet weitere Informationen zur Initiierung des Präzuordnungsvorgangs über den pdwReasonCode-Parameter . Die DLL muss * pdwReasonCode auf eine der folgenden 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 Präzuordnungsvorgang initiiert werden konnte oder nicht.

Weitere Informationen zum Vorgang vor der Zuordnung finden Sie unter Pre-Association Operation.

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, L2cmn.h)