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