Funzione EapPeerSetCredentials (eapmethodpeerapis.h)
Fornisce credenziali di autenticazione nuove o aggiornate al metodo EAP.
Sintassi
DWORD EapPeerSetCredentials(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] LPWSTR pwszIdentity,
[in] LPWSTR pwszPassword,
[out] EAP_ERROR **ppEapError
);
Parametri
[in] sessionHandle
Puntatore a una struttura EAP_SESSION_HANDLE che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionHandle in una chiamata precedente a EapPeerBeginSession.
[in] pwszIdentity
Puntatore che specifica l'identità utente per cui impostare le credenziali. Questa stringa di identità utente viene ottenuta chiamando la funzione EapPeerGetIdentity .
[in] pwszPassword
Puntatore contenente la password di testo cancella per l'identità utente.
[out] ppEapError
Puntatore a un puntatore a una struttura di 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 EapPeerFreeErrorMemory.
Valore restituito
nessuno
Osservazioni
Se la chiave del Registro di sistema InvokeUserNameDlg è impostata, è necessario esportare EapPeerSetCredentials . Se la chiave del Registro di sistema InvokeUserNameDlg non è impostata, EapPeerSetCredentials deve esportare le funzioni EapPeerGetIdentity e EapPeerInvokeIdentityUI .
Questa chiamata viene eseguita da un EAPHost basato su peer usando un puntatore di funzione a questa API. Questa API deve essere implementata nel metodo EAP caricato da EAPHost e deve essere strettamente conforme ai tipi di sintassi e di parametri specificati nella documentazione.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | eapmethodpeerapis.h |