funzione di callback DOT11EXTIHV_VALIDATE_PROFILE (wlanihv.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

Il sistema operativo chiama la funzione Dot11ExtIhvValidateProfile per convalidare i dati utente immessi per un profilo di rete. La DLL di estensioni IHV è responsabile solo della verifica dei dati per i frammenti del profilo di connettività e sicurezza definiti dall'IHV.

Sintassi

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
)
{...}

Parametri

[in, optional] hIhvExtAdapter

Handle usato dalla DLL delle estensioni IHV per fare riferimento all'adattatore LAN wireless (WLAN). Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] pIhvProfileParams

Puntatore a DOT11EXT_IHV_PROFILE_PARAMS struttura. Questa struttura definisce gli attributi della rete BSS (Basic Service Set) a cui verranno applicate le estensioni del profilo.

[in] pIhvConnProfile

Puntatore a DOT11EXT_IHV_CONNECTIVITY_PROFILE struttura che contiene le impostazioni di connettività per il profilo IHV.

[in] pIhvSecProfile

Puntatore a DOT11EXT_IHV_SECURITY_PROFILE struttura che contiene le impostazioni di sicurezza per il profilo IHV.

[out] pdwReasonCode

Puntatore a un valore DWORD, che fornisce informazioni aggiuntive per il valore restituito della funzione Dot11ExtIhvValidateProfile . La DLL delle estensioni IHV deve impostare * pdwReasonCode su un valore L2_REASON_CODE_xxxx, definito in L2cmn.h.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

Il sistema operativo chiama la funzione Dot11ExtIhvValidateProfile per verificare le impostazioni specificate dall'utente per un profilo di rete prima che il profilo venga elaborato o salvato.

Quando viene chiamata la funzione Dot11ExtIhvValidateProfile , la DLL delle estensioni IHV segue queste linee guida:

La DLL delle estensioni IHV verifica che le impostazioni del profilo specificate dall'utente siano valide per gli attributi generali della rete BSS (Basic Service Set) a cui verrà applicato il profilo. Gli attributi di rete BSS vengono a cui si fa riferimento tramite il parametro pIhvProfileParams .
Se i dati utente sono validi per le estensioni del profilo di rete, Dot11ExtIhvValidateProfile deve restituire ERROR_SUCCESS. In caso contrario, la funzione deve restituire un codice di errore appropriato dai valori ERROR_xxxx definiti in Winerror.h.
La DLL delle estensioni IHV fornisce altre informazioni sui risultati della convalida dei dati utente. La DLL deve impostare * pdwReasonCode su uno dei seguenti elementi:
- L2_REASON_CODE_SUCCESS, se i dati utente sono validi.
- Valore di errore appropriato L2_REASON_CODE_xxxx, se i dati utente non sono validi.
- Valore definito da IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), indipendentemente dalla validità dei dati utente.

Per altre informazioni sullo schema XML native 802.11, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	wlanihv.h (include Wlanihv.h, L2cmn.h)

Vedi anche

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Condividi tramite