Função EapPeerBeginSession (eapmethodpeerapis.h)
Inicia uma sessão de autenticação EAP no EAPHost par usando o método EAP.
Sintaxe
DWORD EapPeerBeginSession(
[in] DWORD dwFlags,
[in] const EapAttributes * const pAttributeArray,
[in] HANDLE hTokenImpersonateUser,
[in] DWORD dwSizeofConnectionData,
[in] BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] BYTE *pUserData,
[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 novo comportamento da sessão de autenticação EAP.
[in] pAttributeArray
Um ponteiro para uma estrutura de matriz EAP_ATTRIBUTES que especifica os atributos EAP da entidade a serem autenticados.
[in] hTokenImpersonateUser
Especifica um identificador para o token de representação do usuário a ser usado nesta sessão.
[in] dwSizeofConnectionData
Especifica o tamanho, em bytes, do buffer de dados de conexão fornecido em pConnectionData.
[in] pConnectionData
Dados de conexão específicos a esse método usado para decidir os dados do usuário retornados dessa API, em que os dados do usuário dependem de determinada configuração de dados de conexão. Quando esse parâmetro for NULL , a implementação do método deverá usar valores padrão para conexão.
[in] dwSizeofUserData
Especifica o tamanho em bytes do buffer de dados do usuário fornecido em pUserData.
[in] pUserData
Um ponteiro para um buffer de bytes que contém o BLOB de dados do usuário opaco.
[in] dwMaxSendPacketSize
Especifica o tamanho máximo em bytes de um pacote EAP enviado durante a sessão. Se o método precisar enviar um pacote maior que o tamanho máximo, o método deverá acomodar a fragmentação e a remontagem.
[out] pSessionHandle
Um ponteiro para uma estrutura EAP_SESSION_HANDLE que contém o identificador exclusivo para esta sessão de autenticação EAP no servidor EAPHost.
[out] ppEapError
Um ponteiro para um ponteiro para uma estrutura EAP_ERROR que contém erros gerados durante a execução dessa chamada de função. Depois de consumir os dados de erro, essa memória deve ser liberada chamando EapPeerFreeErrorMemory.
Valor retornado
Nenhum
Comentários
Essa chamada é executada por um EAPHost baseado em pares usando um ponteiro de função para essa API. Essa API deve ser implementada no método EAP carregado pelo EAPHost e deve estar estritamente em conformidade com a sintaxe e os tipos de parâmetro especificados na documentação.
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 | eapmethodpeerapis.h |