Función WTSConnectSessionW (wtsapi32.h)
Conecta una sesión de Servicios de Escritorio remoto a una sesión existente en el equipo local.
Sintaxis
BOOL WTSConnectSessionW(
[in] ULONG LogonId,
[in] ULONG TargetLogonId,
[in] PWSTR pPassword,
[in] BOOL bWait
);
Parámetros
[in] LogonId
Identificador de inicio de sesión de la sesión a la 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 que se va a 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
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 |