Função EapMethodAuthenticatorBeginSession (eapmethodauthenticatorapis.h)

Cria uma nova sessão de autenticação EAP no servidor EAPHost.

EapMethodAuthenticatorBeginSession é um protótipo de função.

Sintaxe

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parâmetros

[in] dwFlags

Uma combinação de sinalizadores EAP que descrevem o comportamento da sessão de autenticação EAP.

[in] bInitialId

Uma cadeia de caracteres Unicode terminada em zero que contém a identidade do usuário a ser autenticado.

pwszIdentity

Identidade do usuário que está sendo autenticado.

[in] pAttributeArray

Um ponteiro para uma estrutura de matriz EapAttributes que especifica os atributos EAP da entidade a ser autenticada.

[in] dwSizeofConnectionData

Especifica o tamanho em bytes dos dados apontados por pConnectionData. Se pConnectionData for NULL, esse membro será zero.

pConnectionData

Ponteiro para os dados de conexão recebidos da interface do usuário de configuração do protocolo de autenticação.

[in] dwMaxSendPacketSize

Especifica o tamanho máximo, em bytes, de um pacote EAP enviado durante a sessão.

[out] pSessionHandle

Um ponteiro para uma estrutura de EAP_SESSION_HANDLE que contém o identificador exclusivo para essa sessão de autenticação EAP no servidor EAPHost.

[out] ppEapError

Opcionalmente, recebe um ponteiro para um ponteiro para uma estrutura EAP_ERROR que contém quaisquer erros gerados pelo EAPHost durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada passando um ponteiro para os dados de erro para EapMethodAuthenticatorFreeMemory.

Retornar valor

Nenhum

Comentários

Essa chamada é executada por um EAPHost baseado em autenticador usando um ponteiro de função para essa API. Essa API deve ser implementada no método autenticador EAP carregado pelo EAPHost e deve estar estritamente em conformidade com a sintaxe e os tipos de parâmetro especificados na documentação.

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	eapmethodauthenticatorapis.h

Confira também

Funções do método Authenticator EAPHost

EapHostPeerBeginSession