WTSStartRemoteControlSessionA 函数 (wtsapi32.h)

启动另一个远程桌面服务会话的远程控制。 必须从远程会话调用此函数。

语法

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

参数

[in] pTargetServerName

指向要远程控制其会话的服务器名称的指针。

[in] TargetLogonId

要远程控制的会话的登录 ID。

[in] HotkeyVk

表示要按下的键以停止会话的远程控制的虚拟键代码。 此参数中定义的密钥与 HotkeyModifiers 参数一起使用。

[in] HotkeyModifiers

表示要按下以停止会话远程控制的键的虚拟修饰符。 虚拟修饰符与 HotkeyVk 参数一起使用。

例如,如果将 WTSStartRemoteControlSession 函数调用,HotkeyVk 设置为 VK_MULTIPLYHotkeyModifiers 设置为 REMOTECONTROL_KBDCTRL_HOTKEY,则具有目标会话远程控制的用户可以按 Ctrl + * 停止会话的远程控制并返回到自己的会话。

REMOTECONTROL_KBDSHIFT_HOTKEY

SHIFT 键

REMOTECONTROL_KBDCTRL_HOTKEY

Ctrl 键

REMOTECONTROL_KBDALT_HOTKEY

Alt 键

返回值

如果函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError

言论

注意

wtsapi32.h 标头将 WTSStartRemoteControlSession 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 带 SP1 的 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 wtsapi32.h
Wtsapi32.lib
DLL Wtsapi32.dll