Función EapHostPeerGetResult (eappapis.h)
Obtiene el resultado de autenticación de la sesión de autenticación de EAP especificada.
Sintaxis
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] sessionHandle
Puntero a una estructura de EAP_SESSIONID que contiene el identificador único de esta sesión de autenticación de EAP en el servidor EAPHost. Este identificador se devuelve en el parámetro pSessionId en una llamada anterior a EapHostPeerBeginSession.
[in] reason
Valor de enumeración EapHostPeerMethodResultReason que especifica el código de motivo para el resultado de autenticación devuelto en ppResult.
[out] ppResult
Puntero a una estructura EapHostPeerMethodResultReason que contiene los resultados de autenticación. EAPHost rellena esta estructura con información relacionada con la autenticación definida en EapHostPeerMethodResult.
[out] ppEapError
Puntero a la dirección de una estructura de EAP_ERROR . La dirección debe establecerse en NULL antes de llamar a esta función. Si hay datos de error disponibles, se recibe un puntero a la dirección de una estructura de EAP_ERROR que contiene los errores que se producen durante la ejecución de esta llamada de función. Los supplicantes deben hacer referencia a este parámetro para determinar si la autenticación se realizó correctamente. Después de usar los datos de error, libere esta memoria llamando a EapHostPeerFreeEapError.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. El valor devuelto no indica si la autenticación se realizó correctamente. Los supplicants deben hacer referencia al parámetro ppEapError para determinar el resultado de la autenticación.
Si se produce un error en la función, el valor devuelto debe ser un código de error adecuado de Winerror.h, Raserror.h o Mprerror.h.
Comentarios
El supplicante llama a EapHostPeerGetResult al completar una autenticación, que puede producirse en cualquiera de los escenarios siguientes.
- Una llamada a EapHostPeerProcessReceivedPacket devolvió el código de acción EapHostPeerResponseResult .
- El cliente agota el tiempo de espera y quiere obtener el resultado en función del estado actual.
- El suplicante recibió un resultado alternativo, quizás de un paquete en la capa inferior.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | eappapis.h |
| Library | Eappprxy.lib |
| Archivo DLL | Eappprxy.dll |