Método ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)
Autentica um usuário.
O Gateway de Área de Trabalho Remota (Gateway de Área de Trabalho Remota) chama esse método quando recebe uma nova solicitação de conexão. O plug-in de autenticação deve autenticar o usuário com base no cookie referenciado pelo parâmetro cookieData . O plug-in de autenticação deve usar a interface ITSGAuthenticateUserSink para notificar o Gateway de Área de Trabalho Remota sobre o resultado da autenticação.
Sintaxe
HRESULT AuthenticateUser(
[in] GUID mainSessionId,
[in] BYTE *cookieData,
[in] ULONG numCookieBytes,
[in] ULONG_PTR context,
[in] ITSGAuthenticateUserSink *pSink
);
Parâmetros
[in] mainSessionId
Um identificador exclusivo atribuído à solicitação de conexão pelo Gateway de Área de Trabalho Remota.
[in] cookieData
Um ponteiro para um BYTE que contém o cookie fornecido pelo usuário.
[in] numCookieBytes
O número de bytes referenciados pelo parâmetro cookieData .
[in] context
Um ponteiro para um ULONG que contém um valor específico para essa conexão. Esse valor deve ser passado de volta para o Gateway de Área de Trabalho Remota usando os métodos da interface ITSGAuthenticateUserSink .
[in] pSink
Um ponteiro para uma interface ITSGAuthenticateUserSink que o plug-in de autenticação deve usar para notificar o Gateway de Área de Trabalho Remota sobre o resultado da autenticação.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Se esse método retornar S_OK, o Gateway de Área de Trabalho Remota aguardará que o plug-in de autenticação chame um método da interface ITSGAuthenticateUserSink . Se qualquer outro valor for retornado, o Gateway de Área de Trabalho Remota negará imediatamente a solicitação de conexão.
Para obter um exemplo que usa o método AuthenticateUser , consulte o exemplo autenticação e autorização conectáveis do Gateway de Área de Trabalho Remota .
Requisitos
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Plataforma de Destino | Windows |
| Cabeçalho | tsgauthenticationengine.h |