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

Das Betriebssystem ruft die Dot11ExtIhvCreateDiscoveryProfiles Funktion auf, um temporäre Verbindungs- und Sicherheitsprofilfragmente zurückzugeben, die zum Herstellen einer Verbindung mit einem standarddienstsatz (BSS)-Netzwerk verwendet werden können, für das kein Netzwerkprofil vorhanden ist.

Syntax

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [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] bInsecure

Ein boolescher Wert, der den Sicherheitsstatus der Ermittlungsprofile angibt. Wenn dieser Wert auf TRUEfestgelegt ist, kann die IHV-Erweiterungs-DLL nur sichere Profile zurückgeben, z. B. Profile, die die Benutzerauthentifizierung erfordern.

[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, optional] pConnectableBssid

Ein Zeiger auf eine DOT11_BSS_LIST Struktur, die einen oder mehrere 802.11 Beacon- oder Probeantwortframes enthält, die von einem BSS-Netzwerk empfangen werden. Diese Liste wird aus den Ergebnissen des letzten Scanvorgangs abgeleitet, der vom WLAN-Adapter ausgeführt wird. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11 Scan Operations.

Hinweis Für Windows Vista unterstützt die IHV-Erweiterungs-DLL nur Infrastruktur-Basisdienste (BSS)-Netzwerke.

[out] pIhvDiscoveryProfileList

Ein Zeiger auf ein DOT11EXT_IHV_DISCOVERY_PROFILE_LIST Struktur, die eine Liste der IHV-Ermittlungsprofile angibt.

[out] pdwReasonCode

Ein Zeiger auf einen DWORD-Wert, der zusätzliche Informationen für den Rückgabewert der Dot11ExtIhvCreateDiscoveryProfiles-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 der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Nachdem der WLAN-Adapter einen Scanvorgang abgeschlossen hat, ruft das Betriebssystem möglicherweise Dot11ExtIhvCreateDiscoveryProfiles auf, um temporäre Profilfragmente zu erstellen, die zum Herstellen einer Verbindung mit einem BSS-Netzwerk verwendet werden können, für das kein Netzwerkprofil vom Benutzer erstellt wurde.

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

Wenn die IHV-Erweiterungs-DLL Profilfragmente zurückgeben kann, die zum Herstellen einer Verbindung mit dem BSS-Netzwerk verwendet werden können, muss die Dot11ExtIhvCreateDiscoveryProfiles-Funktion ERROR_SUCCESS zurückgeben. Andernfalls muss die Funktion einen entsprechenden Fehlercode aus den in Winerror.h definierten ERROR_xxxx Werten zurückgeben.
Die IHV Extensions DLL stellt weitere Informationen zum Rückgabeergebnis der Dot11ExtIhvCreateDiscoveryProfiles Funktion bereit. Die DLL muss * pdwReasonCode- auf eine der folgenden Festlegen festlegen:
- L2_REASON_CODE_SUCCESS, wenn Profilfragmente für die Liste der BSS-Netzwerke zurückgegeben werden können.
- Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert, wenn die Profilfragmente nicht für die Liste der BSS-Netzwerke zurückgegeben werden können.
- 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 Profilfragmente zurückgegeben werden.

Weitere Informationen zum Erstellen von Ermittlungsprofilen finden Sie unter Creating Network Profile Extensions.

Anforderungen

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