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 標頭會根據 UNICODE 預處理器常數的定義，將 WTSStartRemoteControlSession 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista SP1
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wtsapi32.h
程式庫 Wtsapi32.lib
Dll Wtsapi32.dll