DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Rückruffunktion (wlanihv.h)
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.
[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.
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) |