DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Rückruffunktion (wlanihv.h)

Artikel
02/27/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 Dot11ExtIhvCreateDiscoveryProfiles-Funktion auf, um temporäre Konnektivitäts- und Sicherheitsprofilfragmente zurückzugeben, die zum Herstellen einer Verbindung mit einem BSS-Netzwerk (Basic Service Set) 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 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] bInsecure

Ein boolescher Wert, der die sicherheitsrelevante status der Ermittlungsprofile angibt. Wenn dieser Wert auf TRUE festgelegt ist, kann die DLL für IHV-Erweiterungen nur sichere Profile zurückgeben, z. B. Profile, die eine Benutzerauthentifizierung beinhalten.

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

Ein Zeiger auf eine DOT11_BSS_LIST-Struktur , die mindestens ein 802.11-Beacon- oder Testantwortframes 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 wurde. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11-Scanvorgänge.

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

[out] pIhvDiscoveryProfileList

Ein Zeiger auf eine 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 DLL für IHV-Erweiterungen 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 in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Nachdem der WLAN-Adapter einen Überprüfungsvorgang 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 vom Benutzer kein Netzwerkprofil erstellt wurde.

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

Wenn die DLL für IHV-Erweiterungen 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 geeigneten Fehlercode aus den in Winerror.h definierten ERROR_xxxx-Werten zurückgeben.
Die DLL für IHV-Erweiterungen bietet weitere Informationen zum Rückgabeergebnis der Dot11ExtIhvCreateDiscoveryProfiles-Funktion . Die DLL muss * pdwReasonCode auf eine der folgenden Festlegen:
- L2_REASON_CODE_SUCCESS, ob Profilfragmente für die Liste der BSS-Netzwerke zurückgegeben werden können.
- Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert, wenn die Profilfragmente für die Liste der BSS-Netzwerke nicht 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 Erstellen von Netzwerkprofilerweiterungen.

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