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 |