Compartir a través de

Función WTSStartRemoteControlSessionA (wtsapi32.h)

  • Artículo

Inicia el control remoto de otra sesión de Servicios de Escritorio remoto. Debe llamar a esta función desde una sesión remota.

Sintaxis

BOOL WTSStartRemoteControlSessionA(
  [in] LPSTR  pTargetServerName,
  [in] ULONG  TargetLogonId,
  [in] BYTE   HotkeyVk,
  [in] USHORT HotkeyModifiers
);

Parámetros

[in] pTargetServerName

Puntero al nombre del servidor en el que existe el control remoto de la sesión.

[in] TargetLogonId

Identificador de inicio de sesión de la sesión de la que desea controlar de forma remota.

[in] HotkeyVk

Código de clave virtual que representa la tecla que se va a presionar para detener el control remoto de la sesión. La clave que se define en este parámetro se usa con el parámetro HotkeyModifiers .

[in] HotkeyModifiers

Modificador virtual que representa la tecla que se va a presionar para detener el control remoto de la sesión. El modificador virtual se usa con el parámetro HotkeyVk.

Por ejemplo, si se llama a la función WTSmoteControlSession con hotkeyVk establecido en VK_MULTIPLY y HotkeyModifiers establecido en REMOTECONTROL_KBDCTRL_HOTKEY, el usuario que tiene control remoto de la sesión de destino puede presionar CTRL + * para detener el control remoto de la sesión y volver a su propia sesión.

REMOTECONTROL_KBDSHIFT_HOTKEY

Tecla MAYÚS

REMOTECONTROL_KBDCTRL_HOTKEY

Tecla CTRL

REMOTECONTROL_KBDALT_HOTKEY

Tecla ALT

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

Nota

El encabezado wtsapi32.h define WTSStartRemoteControlSession 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