Função EapHostPeerGetAuthStatus (eappapis.h)

Artigo
08/23/2023

Obtém o status de autenticação EAP atual do supplicante do EAPHost.

Sintaxe

DWORD EapHostPeerGetAuthStatus(
  [in]  EAP_SESSIONID         sessionHandle,
  [in]  EapHostPeerAuthParams authParam,
  [out] DWORD                 *pcbAuthData,
  [out] BYTE                  **ppAuthData,
  [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] authParam

Um valor de enumeração EapHostPeerAuthParams que especifica o tipo de dados de autenticação EAP a serem obtidos do EAPHost.

Valor	Significado
EapHostPeerAuthStatus	ppAuthData contém uma estrutura EAPHOST_AUTH_INFO .
EapHostPeerIdentity	ppAuthData contém um buffer WCHAR .
EapHostPeerIdentityExtendedInfo	ppAuthData contém um buffer CHAR .
EapHostNapInfo	Windows 7 ou posterior: estrutura [EapHostPeerNapInfo](/windows/win32/eaphost/eaphostpeernapinfo).

[out] pcbAuthData

O tamanho, em bytes, do buffer de dados de autenticação EAP apontado pelo parâmetro ppAuthData .

[out] ppAuthData

Um ponteiro para um ponteiro para um buffer de bytes que contém os dados de autenticação do EAPHost. O formato desses dados depende do valor fornecido em authParam.

[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

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

Confira também

Funções de Run-Time do EAPHost Supplicant

Compartilhar via