Compartir a través de

Función WTSConnectSessionA (wtsapi32.h)

  • Artículo

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 que se especifica 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 esperar a que se complete la operación o false devolver inmediatamente.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

El LogonId o parámetro 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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista con SP1
servidor mínimo admitido Windows Server 2008
de la plataforma de destino de Windows
encabezado de wtsapi32.h
biblioteca de Wtsapi32.lib
DLL de Wtsapi32.dll