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 donde existe el control remoto de la sesión de .

[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 WTSStartRemoteControlSession 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 la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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 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