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 |