Функция WTSStartRemoteControlSessionA (wtsapi32.h)
Запускает удаленное управление другим сеансом служб удаленных рабочих столов. Эту функцию необходимо вызвать из удаленного сеанса.
Синтаксис
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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista с пакетом обновления 1 (SP1) |
Минимальная версия сервера | Windows Server 2008 |
Целевая платформа | Windows |
Header | wtsapi32.h |
Библиотека | Wtsapi32.lib |
DLL | Wtsapi32.dll |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по