DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA funzione di callback (wlanihv.h)

Articolo
02/27/2024

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 Dot11ExtSetProfileCustomUserData per salvare i dati all'interno del Registro di sistema specifico dell'utente corrente e del profilo di rete usato per la connessione di rete del set di servizi di base .

Sintassi

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

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. Questo valore di handle è stato specificato tramite una chiamata precedente a Dot11ExtIhvPerformPreAssociate Funzione gestore IHV.

[in] dwSessionID

Identificatore di sessione (ID sessione) dell'utente corrente.

[in] dwDataSize

Dimensioni, in byte, del buffer a cui fa riferimento pvData .

[in] pvData

Puntatore a un buffer allocato dal chiamante, che contiene i dati in un formato definito dall'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

Il sistema operativo non crittograferà i dati a cui fa riferimento il parametro pvData prima di archiviarli nel Registro di sistema. La DLL delle estensioni IHV deve usare il proprio algoritmo di crittografia per crittografare i dati prima di chiamare Dot11ExtSetProfileCustomUserData.

Per ogni profilo WLAN wireless utilizzato dal servizio Native Wifi AutoConfig, Windows mantiene il concetto di dati utente personalizzati. Questi dati utente personalizzati inizialmente non esistono, ma possono essere impostati chiamando la funzione Dot11ExtSetProfileCustomUserData . I dati utente personalizzati vengono reimpostati su vuoti ogni volta che il profilo viene modificato chiamando Funzione Dot11ExtSetCurrentProfile .

Dopo aver impostato i dati utente personalizzati, è possibile accedere a questi dati usando il Funzione Dot11ExtGetProfileCustomUserData . Il sistema operativo archivia i dati nel Registro di sistema HKEY_CURRENT_USER chiave per l'utente a cui fa riferimento l'handle passato nel parametro dwSessionID .

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

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData

Condividi tramite