Функция WTSStartRemoteControlSessionA (wtsapi32.h)

Статья
11/20/2024

Запускает удаленный контроль другого сеанса служб удаленных рабочих столов. Эту функцию необходимо вызвать из удаленного сеанса.

Синтаксис

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

Параметры

[in] pTargetServerName

Указатель на имя сервера, в котором требуется удаленное управление сеансом.

[in] TargetLogonId

Идентификатор входа сеанса, на который требуется удаленное управление.

[in] HotkeyVk

Код виртуального ключа, представляющий клавишу для нажатия клавиши, чтобы остановить удаленный контроль сеанса. Ключ, определенный в этом параметре, используется с параметром HotkeyModifiers.

[in] HotkeyModifiers

Виртуальный модификатор, представляющий клавишу для остановки удаленного управления сеансом. Виртуальный модификатор используется с параметром HotkeyVk.

Например, если функция WTSStartRemoteControlSession вызывается с HotkeyVk для параметра VK_MULTIPLY и HotkeyModifiers задано значение REMOTECONTROL_KBDCTRL_HOTKEY, пользователь, имеющий удаленный доступ к целевому сеансу, может нажать клавиши CTRL+* для остановки удаленного управления сеансом и вернуться к собственному сеансу.

REMOTECONTROL_KBDSHIFT_HOTKEY

Клавиша SHIFT

REMOTECONTROL_KBDCTRL_HOTKEY

Клавиша CTRL

REMOTECONTROL_KBDALT_HOTKEY

Клавиша ALT

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение является ненулевое значение.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Заметка

Заголовок wtsapi32.h определяет WTSStartRemoteControlSession в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista с пакетом обновления 1 (SP1)
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	wtsapi32.h
библиотеки	Wtsapi32.lib
DLL	Wtsapi32.dll

Поделиться через