DOT11EXT_SET_CURRENT_PROFILE funzione di callback (wlanihv.h)

  • Articolo
Importante L'interfaccia LAN wireless native 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.
 
La DLL delle estensioni IHV chiama la funzione Dot11ExtSetCurrentProfile per specificare le impostazioni per i frammenti di profilo di sicurezza e connettività definiti da IHV. Questi frammenti verranno applicati al profilo di rete corrente.

Sintassi

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Parametri

[in, optional] hDot11SvcHandle

Handle utilizzato dal sistema operativo per fare riferimento alla scheda LAN wireless (WLAN). Questo valore handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Handle utilizzato dal sistema operativo per fare riferimento alla sessione di connessione con la rete BSS (Basic Service Set). Questo valore di handle è stato specificato tramite una chiamata precedente a Dot11ExtIhvPerformPreAssociate Funzione gestore IHV.

[in, optional] pIhvConnProfile

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

[in, optional] pIhvSecProfile

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

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

La funzione Dot11ExtSetCurrentProfile consente all'IHV di aggiungere frammenti di profilo di sicurezza e connettività personalizzati al profilo di rete corrente usato per la connessione di rete BSS (Basic Service Set). I frammenti di profilo sono specifici di IHV e sono applicabili alle estensioni di connettività o di sicurezza disponibili per l'utente tramite la DLL delle estensioni dell'interfaccia utente IHV native 802.11.

La DLL delle estensioni IHV deve seguire queste linee guida quando si chiama la funzione Dot11ExtSetCurrentProfile :

  • La DLL delle estensioni IHV deve chiamare Dot11ExtSetCurrentProfile solo quando si esegue un'operazione di pre-associazione avviata tramite una chiamata a Dot11ExtIhvPerformPreAssociate Funzione gestore IHV. Per altre informazioni sull'operazione di pre-associazione, vedere Pre-Association Operation.For more information about the pre-association operation, see Pre-Association Operation.
  • La DLL delle estensioni IHV non deve chiamare Dot11ExtSetCurrentProfile dall'interno della chiamata alla Dot11ExtIhvPerformPreAssociate Funzione gestore IHV. Dot11ExtSetCurrentProfile deve essere chiamato da un thread diverso da quello che sta elaborando la chiamata a Dot11ExtIhvPerformPreAssociate.

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)

Vedi anche

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE