Funzione EapHostPeerGetIdentity (eappapis.h)
Questa funzione viene chiamata dai metodi di tunnel per richiedere informazioni sull'identità dai metodi interni. Questa funzione restituisce le informazioni sull'identità e sulle credenziali utente.
Sintassi
DWORD EapHostPeerGetIdentity(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError,
[in, out] BYTE **ppvReserved
);
Parametri
[in] dwVersion
Numero di versione dell'API. Deve essere impostato su zero.
[in] dwFlags
Combinazione di flag EAP che descrivono il comportamento della sessione di autenticazione EAP.
[in] eapMethodType
Struttura EAP_METHOD_TYPE che specifica il tipo di autenticazione EAP da usare per questa sessione.
[in] dwSizeofConnectionData
Dimensioni del buffer indicate dal parametro pConnectionData , in byte.
[in] pConnectionData
Puntatore ai dati di configurazione usati per il metodo EAP.
[in] dwSizeofUserData
Dimensioni del buffer indicate dal parametro pUserData , in byte.
[in] pUserData
Puntatore alle informazioni sulle credenziali utente relative a questa sessione di autenticazione.
[in] hTokenImpersonateUser
Token di rappresentazione per un utente connesso per raccogliere informazioni correlate all'utente.
[out] pfInvokeUI
Restituisce TRUE se l'identità utente e il BLOB di dati utente non vengono restituiti correttamente e il metodo cerca di raccogliere le informazioni dall'utente tramite la finestra di dialogo dell'interfaccia utente.
[in, out] pdwSizeOfUserDataOut
Dimensioni del buffer indicate dal parametro ppUserDataOut , in byte.
[out] ppUserDataOut
Informazioni sui dati utente restituite dal metodo . Dopo l'uso, questa memoria deve essere liberata chiamando EapHostPeerFreeRuntimeMemory.
[out] ppwszIdentity
Puntatore a una stringa di identità utente con terminazione NULL. Dopo l'uso, questa memoria deve essere liberata chiamando EapHostPeerFreeRuntimeMemory.
[out] ppEapError
Puntatore a un puntatore a una struttura EAP_ERROR che contiene eventuali errori generati durante l'esecuzione di questa chiamata di funzione. Dopo aver utilizzato i dati di errore, questa memoria deve essere liberata chiamando EapHostPeerFreeErrorMemory.
[in, out] ppvReserved
Riservate per utilizzo futuro
Valore restituito
nessuno
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | eappapis.h |
| Libreria | Eappprxy.lib |
| DLL | Eapphost.dll |