WTSConnectSessionA-Funktion (wtsapi32.h)

Artikel
11/20/2024

Verbindet eine Remotedesktopdienste-Sitzung mit einer vorhandenen Sitzung auf dem lokalen Computer.

Syntax

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

Parameter

[in] LogonId

Die Anmelde-ID der Sitzung, mit der eine Verbindung hergestellt werden soll. Der Benutzer dieser Sitzung muss über Berechtigungen zum Herstellen einer Verbindung mit einer vorhandenen Sitzung verfügen. Die Ausgabe dieser Sitzung wird an die vom TargetLogonId Parameter identifizierte Sitzung weitergeleitet.

Dies kann LOGONID_CURRENT sein, um die aktuelle Sitzung zu verwenden.

[in] TargetLogonId

Die Anmelde-ID der Sitzung, um die Ausgabe der Sitzung zu empfangen, die durch den parameter LogonId dargestellt wird. Die Ausgabe der sitzung, die durch die LogonId Parameter identifiziert wird, wird an diese Sitzung weitergeleitet.

Dies kann LOGONID_CURRENT sein, um die aktuelle Sitzung zu verwenden.

[in] pPassword

Ein Zeiger auf das Kennwort für das Benutzerkonto, das im parameter LogonId angegeben ist. Der Wert pPassword- kann eine leere Zeichenfolge sein, wenn der Aufrufer mit demselben Domänennamen und Benutzernamen wie die Anmelde-ID angemeldet ist. Der Wert pPassword- kann nicht NULL-sein.

[in] bWait

Gibt an, ob der Vorgang synchron ist. Geben Sie TRUE- an, bis der Vorgang abgeschlossen ist, oder FALSE- sofort zurückzugeben.

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

Der Parameter LogonId oder TargetLogonId Parameter kann LOGONID_CURRENT, jedoch nicht beides sein.

Anmerkung

Der wtsapi32.h-Header definiert WTSConnectSession als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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