Freigeben über


WTSLISTENERCONFIGA-Struktur (wtsapi32.h)

Enthält Informationen zu einem Listener für Remotedesktopdienste. Diese Struktur wird von der WTSCreateListener--Funktion verwendet.

Syntax

typedef struct _WTSLISTENERCONFIGA {
  ULONG version;
  ULONG fEnableListener;
  ULONG MaxConnectionCount;
  ULONG fPromptForPassword;
  ULONG fInheritColorDepth;
  ULONG ColorDepth;
  ULONG fInheritBrokenTimeoutSettings;
  ULONG BrokenTimeoutSettings;
  ULONG fDisablePrinterRedirection;
  ULONG fDisableDriveRedirection;
  ULONG fDisableComPortRedirection;
  ULONG fDisableLPTPortRedirection;
  ULONG fDisableClipboardRedirection;
  ULONG fDisableAudioRedirection;
  ULONG fDisablePNPRedirection;
  ULONG fDisableDefaultMainClientPrinter;
  ULONG LanAdapter;
  ULONG PortNumber;
  ULONG fInheritShadowSettings;
  ULONG ShadowSettings;
  ULONG TimeoutSettingsConnection;
  ULONG TimeoutSettingsDisconnection;
  ULONG TimeoutSettingsIdle;
  ULONG SecurityLayer;
  ULONG MinEncryptionLevel;
  ULONG UserAuthentication;
  CHAR  Comment[WTS_COMMENT_LENGTH + 1];
  CHAR  LogonUserName[USERNAME_LENGTH + 1];
  CHAR  LogonDomain[DOMAIN_LENGTH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;

Angehörige

version

Dieses Mitglied ist reserviert.

fEnableListener

Gibt an, ob der Listener aktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Listener ist deaktiviert.

1

Der Listener ist aktiviert.

MaxConnectionCount

Die maximale Anzahl aktiver Verbindungen, die der Listener akzeptiert.

fPromptForPassword

Gibt an, ob der Listener den Benutzer immer zur Eingabe eines Kennworts auffordert. Dieses Element kann einer der folgenden Werte sein:

0

Fordern Sie den Benutzer nur auf, wenn er vom Server angegeben wird, ein Kennwort einzugeben.

1

Fordern Sie den Benutzer immer zur Eingabe eines Kennworts auf.

fInheritColorDepth

Gibt an, ob der Listener die vom Benutzer angegebene Farbtiefe verwenden soll. Dieses Element kann einer der folgenden Werte sein:

0

Verwenden Sie die vom Server angegebene Farbtiefe.

1

Verwenden Sie die vom Benutzer angegebene Farbtiefe.

ColorDepth

Die Farbtiefeeinstellung für den Listener. Diese Einstellung gilt nur, wenn der fInheritColorDepth Member null ist. Dies kann einer der folgenden Werte sein:

1

8 Bit

2

15 Bit

3

16 Bit

4

24 Bit

5

32 Bit

fInheritBrokenTimeoutSettings

Gibt an, ob der Listener den vom Benutzer angegebenen wert BrokenTimeoutSettings verwenden soll. Dieses Element kann einer der folgenden Werte sein:

0

Verwenden Sie den BrokenTimeoutSettings wert, der vom Server angegeben wird.

1

Verwenden Sie den vom Benutzer angegebenen BrokenTimeoutSettings- Wert.

BrokenTimeoutSettings

Die Aktion, die der Listener ausführt, wenn eine Verbindung oder ein Leerlaufzeitgeber abläuft, oder wenn eine Verbindung aufgrund eines Verbindungsfehlers verloren geht. Diese Einstellung gilt nur, wenn das "fInheritBrokenTimeoutSettings" Element null ist. Dieses Element kann einer der folgenden Werte sein:

0

Wenn eine Verbindung oder ein Leerlaufzeitgeber abläuft oder eine Verbindung aufgrund eines Verbindungsfehlers verloren geht, wird der Benutzer getrennt, die Sitzung verbleibt jedoch auf dem Server.

1

Wenn eine Verbindung oder ein Leerlaufzeitgeber abläuft oder eine Verbindung aufgrund eines Verbindungsfehlers verloren geht, wird die Sitzung beendet.

fDisablePrinterRedirection

Gibt an, ob die Druckerumleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die Druckerumleitung aktivieren.

1

Die Druckerumleitung ist deaktiviert.

fDisableDriveRedirection

Gibt an, ob die Laufwerkumleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die Laufwerkumleitung aktivieren.

1

Die Laufwerkumleitung ist deaktiviert.

fDisableComPortRedirection

Gibt an, ob die COM-Portumleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die COM-Portumleitung aktivieren.

1

Die COM-Portumleitung ist deaktiviert.

fDisableLPTPortRedirection

Gibt an, ob die LPT-Portumleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die LPT-Portumleitung aktivieren.

1

Die LPT-Portumleitung ist deaktiviert.

fDisableClipboardRedirection

Gibt an, ob die Umleitung der Zwischenablage deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die Umleitung der Zwischenablage aktivieren.

1

Die Umleitung der Zwischenablage ist deaktiviert.

fDisableAudioRedirection

Gibt an, ob die Audioumleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die Audioumleitung aktivieren.

1

Die Audioumleitung ist deaktiviert.

fDisablePNPRedirection

Gibt an, ob die Plug- und Play-Umleitung deaktiviert ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Benutzer kann die Plug- und Play-Umleitung aktivieren.

1

Plug and Play Redirection ist deaktiviert.

fDisableDefaultMainClientPrinter

Gibt an, ob der Clientdrucker der Standarddrucker ist. Dieses Element kann einer der folgenden Werte sein:

0

Der Clientdrucker ist nicht der Standarddrucker.

1

Der Clientdrucker ist der Standarddrucker.

LanAdapter

Der vom Listener verwendete Netzwerkadapter.

PortNumber

Die Portnummer des Listeners.

fInheritShadowSettings

Gibt an, ob der Listener den vom Benutzer angegebenen wert ShadowSettings verwenden soll. Dieses Element kann einer der folgenden Werte sein:

0

Verwenden Sie die vom Server angegebene Einstellung.

1

Verwenden Sie die vom Benutzer angegebene Einstellung.

ShadowSettings

Die Remotesteuerungseinstellung für den Listener. Die Remotesteuerung ermöglicht es einem Benutzer, die Bildschirmvorgänge eines anderen Benutzers remote zu überwachen. Diese Einstellung gilt nur, wenn das fInheritShadowSettings Element null ist. Dieses Element kann einer der folgenden Werte sein:

0

Die Fernbedienung ist deaktiviert.

1

Der Benutzer der Fernbedienung verfügt über vollzugriff auf die Sitzung des Benutzers mit der Berechtigung des Benutzers.

2

Der Benutzer der Fernbedienung hat die volle Kontrolle über die Sitzung des Benutzers; Die Berechtigung des Benutzers ist nicht erforderlich.

3

Der Benutzer der Fernbedienung kann die Sitzung remote anzeigen, mit der Berechtigung des Benutzers; Der Remotebenutzer kann die Sitzung nicht aktiv steuern.

4

Der Benutzer der Remotesteuerung kann die Sitzung remote anzeigen, die Sitzung jedoch nicht aktiv steuern; Die Berechtigung des Benutzers ist nicht erforderlich.

TimeoutSettingsConnection

Die maximale Verbindungsdauer in Millisekunden. Jedes Mal, wenn sich der Benutzer anmeldet, wird der Timer zurückgesetzt. Ein Wert von Null gibt an, dass der Verbindungstimer deaktiviert ist.

TimeoutSettingsDisconnection

Die maximale Dauer in Millisekunden, für die ein Server eine getrennte Sitzung aufbewahrt, bevor die Anmeldung beendet wird. Ein Wert von Null gibt an, dass der Trennzeitgeber deaktiviert ist.

TimeoutSettingsIdle

Die maximale Leerlaufzeit in Millisekunden. Ein Wert von Null gibt an, dass der Leerlauftimer deaktiviert ist.

SecurityLayer

Die Sicherheitsebene des Listeners. Dieses Element kann einer der folgenden Werte sein:

0

Remotedesktopprotokoll (RDP) wird vom Server und dem Client für die Authentifizierung verwendet, bevor eine Verbindung hergestellt wird.

1

Der Server und der Client verhandeln die Methode für die Authentifizierung, bevor eine Verbindung hergestellt wird.

2

Das TLS-Protokoll (Transport Layer Security) wird vom Server und dem Client für die Authentifizierung verwendet, bevor eine Verbindung hergestellt wird.

MinEncryptionLevel

Verschlüsselungsebene des Listeners. Dieses Element kann einer der folgenden Werte sein:

1

Vom Client an den Server gesendete Daten werden mithilfe der 56-Bit-Verschlüsselung verschlüsselt. Die vom Server an den Client gesendeten Daten werden nicht verschlüsselt.

2

Alle vom Client an den Server und vom Server an den Client gesendeten Daten werden mithilfe der maximalen Schlüsselstärke verschlüsselt, die vom Client unterstützt wird.

3

Alle vom Client an den Server und vom Server an den Client gesendeten Daten werden mithilfe der 128-Bit-Verschlüsselung verschlüsselt. Clients, die diese Verschlüsselungsstufe nicht unterstützen, können keine Verbindung herstellen.

4

Alle vom Client an den Server und vom Server an den Client gesendeten Daten werden mit den FIPS-Verschlüsselungsalgorithmen (Federal Information Processing Standards) und Microsoft-Kryptografiemodulen verschlüsselt und entschlüsselt.

UserAuthentication

Gibt an, ob die Benutzerauthentifizierung auf Netzwerkebene erforderlich ist, bevor die Verbindung hergestellt wird. Dieses Element kann einer der folgenden Werte sein:

0

Die Benutzerauthentifizierung auf Netzwerkebene ist nicht erforderlich.

1

Die Benutzerauthentifizierung auf Netzwerkebene ist erforderlich.

Comment[WTS_COMMENT_LENGTH + 1]

Eine mit Null beendete Zeichenfolge, die eine Beschreibung des Listeners enthält.

LogonUserName[USERNAME_LENGTH + 1]

Eine mit Null beendete Zeichenfolge, die den Benutzernamen enthält, der in szenarien für die automatische Anmeldung verwendet wird.

LogonDomain[DOMAIN_LENGTH + 1]

Eine mit Null beendete Zeichenfolge, die den In automatischen Anmeldeszenarien verwendeten Domänennamen enthält.

WorkDirectory[MAX_PATH + 1]

Eine mit Null beendete Zeichenfolge, die den Pfad des Arbeitsverzeichnisses des ursprünglichen Programms enthält.

InitialProgram[MAX_PATH + 1]

Eine mit Null beendete Zeichenfolge, die den Namen des Programms enthält, das unmittelbar nach der Anmeldung des Benutzers am Server gestartet werden soll.

Bemerkungen

Anmerkung

Der wtsapi32.h-Header definiert WTSLISTENERCONFIG 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 7
mindestens unterstützte Server- Windows Server 2008 R2
Header- wtsapi32.h

Siehe auch

WTSCreateListener