Función WTSConnectSessionA (wtsapi32.h)

Conecta una sesión de Servicios de Escritorio remoto a una sesión existente en el equipo local.

Sintaxis

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

Parámetros

[in] LogonId

Identificador de inicio de sesión de la sesión al que se va a conectar. El usuario de esa sesión debe tener permisos para conectarse a una sesión existente. La salida de esta sesión se enrutará a la sesión identificada por el parámetro TargetLogonId .

Esto puede ser LOGONID_CURRENT para usar la sesión actual.

[in] TargetLogonId

Identificador de inicio de sesión de la sesión para recibir la salida de la sesión representada por el parámetro LogonId . La salida de la sesión identificada por el parámetro LogonId se enrutará a esta sesión.

Esto puede ser LOGONID_CURRENT para usar la sesión actual.

[in] pPassword

Puntero a la contraseña de la cuenta de usuario especificada en el parámetro LogonId . El valor de pPassword puede ser una cadena vacía si el autor de la llamada ha iniciado sesión con el mismo nombre de dominio y nombre de usuario que el identificador de inicio de sesión. El valor de pPassword no puede ser NULL.

[in] bWait

Indica si la operación es sincrónica. Especifique TRUE para esperar a que se complete la operación o FALSE para que se devuelva inmediatamente.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El parámetro LogonId o TargetLogonId puede ser LOGONID_CURRENT, pero no ambos.

Nota

El encabezado wtsapi32.h define WTSConnectSession como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows Vista con SP1
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wtsapi32.h
Library	Wtsapi32.lib
Archivo DLL	Wtsapi32.dll