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

Consulte también

ITSGAuthenticationEngine