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

Vedi anche

Funzioni di run-time supplicant di EAPHost

EapHostPeerProcessReceivedPacket