DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA funzione di callback (wlanihv.h)
Sintassi
DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;
DWORD Dot11extGetProfileCustomUserData(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwSessionID,
[out] DWORD *pdwDataSize,
[out] LPVOID *ppvData
)
{...}
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] dwSessionID
Identificatore di sessione (ID sessione) dell'utente corrente.
[out] pdwDataSize
Puntatore a una variabile fornita dal chiamante che archivia le dimensioni, in byte, del buffer a cui fa riferimento ppvData .
[out] ppvData
Indirizzo di una variabile del puntatore che archivia l'indirizzo del buffer contenente i dati utente.
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 decrittografa i dati a cui fa riferimento il parametro ppvData dopo la lettura dal Registro di sistema. La DLL delle estensioni IHV deve usare il proprio algoritmo di decrittografia per decrittografare i dati dopo aver chiamato Dot11ExtGetProfileCustomUserData.
Per ogni profilo WLAN wireless utilizzato dal servizio Native Wifi AutoConfig, Windows mantiene il concetto di dati utente personalizzati. Questi dati utente personalizzati sono inizialmente inesistenti, ma possono essere impostati chiamando 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 la funzione Dot11ExtGetProfileCustomUserData .
Il chiamante è responsabile della liberazione della memoria allocata per il buffer a cui punta il parametro ppvData usando la funzione Dot11ExtFreeBuffer .
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) |