Método ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)
Autentica a un usuario.
La puerta de enlace de Escritorio remoto (puerta de enlace de Escritorio remoto) llama a este método cuando recibe una nueva solicitud de conexión. El complemento de autenticación debe autenticar al usuario en función de la cookie a la que hace referencia el parámetro cookieData . Después, el complemento de autenticación debe usar la interfaz ITSGAuthenticateUserSink para notificar a la puerta de enlace de Escritorio remoto el resultado de la autenticación.
Sintaxis
HRESULT AuthenticateUser(
[in] GUID mainSessionId,
[in] BYTE *cookieData,
[in] ULONG numCookieBytes,
[in] ULONG_PTR context,
[in] ITSGAuthenticateUserSink *pSink
);
Parámetros
[in] mainSessionId
Identificador único asignado a la solicitud de conexión por puerta de enlace de Escritorio remoto.
[in] cookieData
Puntero a un BYTE que contiene la cookie proporcionada por el usuario.
[in] numCookieBytes
Número de bytes a los que hace referencia el parámetro cookieData .
[in] context
Puntero a un ULONG que contiene un valor específico de esta conexión. Este valor se debe devolver a la puerta de enlace de Escritorio remoto mediante los métodos de la interfaz ITSGAuthenticateUserSink .
[in] pSink
Puntero a una interfaz ITSGAuthenticateUserSink que el complemento de autenticación debe usar para notificar a la puerta de enlace de Escritorio remoto el resultado de la autenticación.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si este método devuelve S_OK, la puerta de enlace de Escritorio remoto espera a que el complemento de autenticación llame a un método de la interfaz ITSGAuthenticateUserSink . Si se devuelve cualquier otro valor, la puerta de enlace de Escritorio remoto deniega inmediatamente la solicitud de conexión.
Para obtener un ejemplo que use el método AuthenticateUser , consulte el ejemplo autenticación y autorización conectables de puerta de enlace de Escritorio remoto.
Requisitos
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Plataforma de destino | Windows |
| Encabezado | tsgauthenticationengine.h |