Função EapHostPeerSetResponseAttributes (eappapis.h)
Fornece atributos de autenticação EAP atualizados para EAPHost.
Sintaxe
DWORD EapHostPeerSetResponseAttributes(
[in] EAP_SESSIONID sessionHandle,
[in] const EapAttributes * const pAttribs,
[out] EapHostPeerResponseAction *pEapOutput,
[out] EAP_ERROR **ppEapError
);
Parâmetros
[in] sessionHandle
Um ponteiro para uma estrutura EAP_SESSIONID que contém o identificador exclusivo para essa sessão de autenticação EAP no servidor EAPHost. Esse identificador é retornado no parâmetro pSessionId em uma chamada anterior para EapHostPeerBeginSession.
[in] pAttribs
Um ponteiro para uma estrutura EapAttributes que contém uma matriz de novos atributos de resposta de autenticação EAP a serem definidos para o supplicante no EAPHost.
[out] pEapOutput
Um ponteiro para um valor de enumeração EapHostPeerResponseAction que especifica o código de ação para a próxima etapa que o supplicante deve tomar como resposta.
[out] ppEapError
Um ponteiro para o endereço de uma estrutura EAP_ERROR . O endereço deve ser definido como NULL antes de chamar essa função. Se os dados de erro estiverem disponíveis, um ponteiro para o endereço de uma estrutura EAP_ERROR que contenha erros gerados durante a execução dessa chamada de função será recebido. Depois de usar os dados de erro, libere essa memória chamando EapHostPeerFreeEapError.
Valor retornado
Nenhum
Comentários
Para avançar para a próxima etapa no computador de estado após uma chamada para EapHostPeerGetResponseAttributes, o supplicante deve chamar EapHostPeerSetResponseAttributes. O supplicante deve fazer isso para passar uma estrutura EapAttributes válida, mesmo que o suplicante não possa usar os atributos retornados de EapHostPeerGetResponseAttributes.
O exemplo a seguir mostra uma chamada EapHostPeerSetResponseAttributes que é feita exclusivamente para progredir para o próximo estado na 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 com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | eappapis.h |
| Biblioteca | Eappprxy.lib |
| DLL | Eappprxy.dll |