Funzione EapHostPeerGetResult (eappapis.h)
Ottiene il risultato dell'autenticazione per la sessione di autenticazione EAP specificata.
Sintassi
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
Parametri
[in] sessionHandle
Puntatore a una struttura di EAP_SESSIONID che contiene l'handle univoco per questa sessione di autenticazione EAP nel server EAPHost. Questo handle viene restituito nel parametro pSessionId in una chiamata precedente a EapHostPeerBeginSession.
[in] reason
Valore di enumerazione EapHostPeerMethodResultReason che specifica il codice motivo per il risultato dell'autenticazione restituito in ppResult.
[out] ppResult
Puntatore a una struttura EapHostPeerMethodResultReason contenente i risultati dell'autenticazione. EAPHost riempie questa struttura con informazioni correlate all'autenticazione definite in EapHostPeerMethodResult.
[out] ppEapError
Puntatore all'indirizzo di una struttura EAP_ERROR . L'indirizzo deve essere impostato su NULL prima di chiamare questa funzione. Se sono disponibili dati di errore, viene ricevuto un puntatore all'indirizzo di una struttura EAP_ERROR contenente eventuali errori generati durante l'esecuzione di questa chiamata di funzione. I supplici devono fare riferimento a questo parametro per determinare se l'autenticazione è riuscita. Dopo aver usato i dati di errore, liberare questa memoria chiamando EapHostPeerFreeEapError.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR. Il valore restituito non indica se l'autenticazione ha esito positivo. I supplici devono fare riferimento al parametro ppEapError per determinare il risultato dell'autenticazione.
Se la funzione ha esito negativo, il valore restituito deve essere un codice di errore appropriato da Winerror.h, Raserror.h o Mprerror.h.
Commenti
Il supplicant chiama EapHostPeerGetResult al completamento di un'autenticazione, che può verificarsi in uno degli scenari seguenti.
- Una chiamata a EapHostPeerProcessReceivedPacket ha restituito il codice di azione EapHostPeerResponseResult .
- Il client ha eseguito il timeout e vuole ottenere il risultato in base allo stato corrente.
- Il supplicante ha ricevuto un risultato alternativo, forse da un pacchetto sul livello inferiore.
Requisiti
| Requisito | Valore |
|---|---|
| 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 | Eappprxy.dll |