WTSConnectSessionA-Funktion (wtsapi32.h)

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 Sitzung weitergeleitet, die durch den TargetLogonId-Parameter identifiziert wird.

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

[in] TargetLogonId

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

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

[in] pPassword

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

[in] bWait

Gibt an, ob der Vorgang synchron ist. Geben Sie TRUE an, um auf den Abschluss des Vorgangs zu warten, oder false , um sofort zurückzugeben.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der Parameter LogonId oder TargetLogonId kann LOGONID_CURRENT werden, aber nicht beides.

Hinweis

Der wtsapi32.h-Header definiert WTSConnectSession 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

Unterstützte Mindestversion (Client)	Windows Vista mit SP1
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wtsapi32.h
Bibliothek	Wtsapi32.lib
DLL	Wtsapi32.dll