Función EapHostPeerSetResponseAttributes (eappapis.h)
Proporciona atributos de autenticación EAP actualizados a EAPHost.
Sintaxis
DWORD EapHostPeerSetResponseAttributes(
[in] EAP_SESSIONID sessionHandle,
[in] const EapAttributes * const pAttribs,
[out] EapHostPeerResponseAction *pEapOutput,
[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] pAttribs
Puntero a una estructura EapAttributes que contiene una matriz de nuevos atributos de respuesta de autenticación de EAP que se van a establecer para el supplicante en EAPHost.
[out] pEapOutput
Puntero a un valor de enumeración EapHostPeerResponseAction que especifica el código de acción para el paso siguiente que el supplicante debe realizar como respuesta.
[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. Después de usar los datos de error, libere esta memoria llamando a EapHostPeerFreeEapError.
Valor devuelto
None
Observaciones
Para avanzar al siguiente paso en la máquina de estado después de una llamada a EapHostPeerGetResponseAttributes, el supplicant debe llamar a EapHostPeerSetResponseAttributes. El supplicante debe hacerlo para pasar una estructura EapAttributes válida, aunque el supplicante no pueda usar los atributos devueltos desde EapHostPeerGetResponseAttributes.
En el ejemplo siguiente se muestra una llamada EapHostPeerSetResponseAttributes que se realiza únicamente para avanzar al siguiente estado en la máquina de estado.
EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);
// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};
// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);
Requisitos
| 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 |