DOT11EXTIHV_VALIDATE_PROFILE Rückruffunktion (wlanihv.h)

  • Artikel
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 Dot11ExtIhvValidateProfile-Funktion auf, um benutzerdaten zu überprüfen, die für ein Netzwerkprofil eingegeben wurden. Die DLL für IHV-Erweiterungen ist nur für die Überprüfung der Daten für die fragmentierten Konnektivitäts- und Sicherheitsprofile verantwortlich, die von der IHV definiert werden.

Syntax

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [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] 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 enthält.

[out] pdwReasonCode

Ein Zeiger auf einen DWORD-Wert, der zusätzliche Informationen für den Rückgabewert der Dot11ExtIhvValidateProfile-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

Das Betriebssystem ruft die Dot11ExtIhvValidateProfile-Funktion auf, um die vom Benutzer angegebenen Einstellungen für ein Netzwerkprofil zu überprüfen, bevor das Profil verarbeitet oder gespeichert wird.

Wenn die Dot11ExtIhvValidateProfile-Funktion aufgerufen wird, folgt die IHV-Erweiterungs-DLL den folgenden Richtlinien:

  • Die DLL für IHV-Erweiterungen überprüft, ob die benutzerspezifischen Profileinstellungen für die allgemeinen Attribute des BSS-Netzwerks (Basic Service Set) gültig sind, auf das das Profil angewendet wird. Auf die BSS-Netzwerkattribute wird über den Parameter pIhvProfileParams verwiesen.
  • Wenn die Benutzerdaten für die Netzwerkprofilerweiterungen gültig sind, muss Dot11ExtIhvValidateProfile 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 zu den Ergebnissen der Validierung der Benutzerdaten. Die DLL muss * pdwReasonCode auf eine der folgenden Festlegen:
    • L2_REASON_CODE_SUCCESS, wenn die Benutzerdaten gültig sind.
    • Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert, wenn die Benutzerdaten ungültig sind.
    • 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 von der Gültigkeit der Benutzerdaten.
Weitere Informationen zum nativen XML-Schema 802.11 finden Sie in der Microsoft Windows SDK-Dokumentation.

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)

Weitere Informationen

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE