Função EapHostPeerGetResult (eappapis.h)
Obtém o resultado da autenticação para a sessão de autenticação EAP especificada.
Sintaxe
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
Parâmetros
[in] sessionHandle
Um ponteiro para uma estrutura de EAP_SESSIONID que contém o identificador exclusivo para esta sessão de autenticação EAP no servidor EAPHost. Esse identificador é retornado no parâmetro pSessionId em uma chamada anterior para EapHostPeerBeginSession.
[in] reason
Um valor de enumeração EapHostPeerMethodResultReason que especifica o código de motivo para o resultado da autenticação retornado em ppResult.
[out] ppResult
Um ponteiro para uma estrutura EapHostPeerMethodResultReason que contém os resultados da autenticação. O EAPHost preenche essa estrutura com informações relacionadas à autenticação definidas em EapHostPeerMethodResult.
[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. Os supplicantes devem se referir a esse parâmetro para determinar se a autenticação foi bem-sucedida. Depois de usar os dados de erro, libere essa memória chamando EapHostPeerFreeEapError.
Retornar valor
Se a função for bem-sucedida, o valor retornado será NO_ERROR. O valor retornado não indica se a autenticação foi bem-sucedida. Os supplicantes devem se referir ao parâmetro ppEapError para determinar o resultado da autenticação.
Se a função falhar, o valor retornado deverá ser um código de erro apropriado de Winerror.h, Raserror.h ou Mprerror.h.
Comentários
O supplicante chama EapHostPeerGetResult após a conclusão de uma autenticação, o que pode ocorrer em qualquer um dos cenários a seguir.
- Uma chamada para EapHostPeerProcessReceivedPacket retornou o código de ação EapHostPeerResponseResult .
- O cliente atingiu o tempo limite e deseja obter o resultado com base no estado atual.
- O suplicante recebeu um resultado alternativo, talvez de um pacote na camada inferior.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |