WTSStartRemoteControlSessionW-Funktion (wtsapi32.h)

Artikel
11/20/2024

Startet die Remotesteuerung einer anderen Remotedesktopdienste-Sitzung. Sie müssen diese Funktion aus einer Remotesitzung aufrufen.

Syntax

BOOL WTSStartRemoteControlSessionW(
  [in] LPWSTR pTargetServerName,
  [in] ULONG  TargetLogonId,
  [in] BYTE   HotkeyVk,
  [in] USHORT HotkeyModifiers
);

Parameter

[in] pTargetServerName

Ein Zeiger auf den Namen des Servers, auf dem die Sitzung vorhanden sein soll.

[in] TargetLogonId

Die Anmelde-ID der Sitzung, von der Sie die Remotesteuerung erhalten möchten.

[in] HotkeyVk

Der virtuelle Schlüsselcode, der die Taste darstellt, um die Remotesteuerung der Sitzung zu beenden. Der in diesem Parameter definierte Schlüssel wird mit den HotkeyModifiers Parameter verwendet.

[in] HotkeyModifiers

Der virtuelle Modifizierer, der die Taste darstellt, um die Remotesteuerung der Sitzung zu beenden. Der virtuelle Modifizierer wird mit dem HotkeyVk Parameter verwendet.

Wenn die WTSStartRemoteControlSession-Funktion beispielsweise mit HotkeyVk aufgerufen wird, auf VK_MULTIPLY und HotkeyModifier s auf REMOTECONTROL_KBDCTRL_HOTKEYfestgelegt ist, kann der Benutzer, der die Remotesteuerung der Zielsitzung hat, STRG + * drücken, um die Remotesteuerung der Sitzung zu beenden und zur eigenen Sitzung zurückzukehren.

REMOTECONTROL_KBDSHIFT_HOTKEY

UMSCHALTTASTE

REMOTECONTROL_KBDCTRL_HOTKEY

STRG-TASTE

REMOTECONTROL_KBDALT_HOTKEY

ALT-TASTE

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der wtsapi32.h-Header definiert WTSStartRemoteControlSession als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista mit SP1
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	wtsapi32.h
Library	Wtsapi32.lib
DLL-	Wtsapi32.dll

Freigeben über