WRDS_CONNECTION_SETTINGS_1-Struktur (wtsdefs.h)
Enthält Verbindungseinstellungsinformationen für eine Remotesitzung.
Syntax
typedef struct _WRDS_CONNECTION_SETTINGS_1 {
BOOLEAN fInheritInitialProgram;
BOOLEAN fInheritColorDepth;
BOOLEAN fHideTitleBar;
BOOLEAN fInheritAutoLogon;
BOOLEAN fMaximizeShell;
BOOLEAN fDisablePNP;
BOOLEAN fPasswordIsScPin;
BOOLEAN fPromptForPassword;
BOOLEAN fDisableCpm;
BOOLEAN fDisableCdm;
BOOLEAN fDisableCcm;
BOOLEAN fDisableLPT;
BOOLEAN fDisableClip;
BOOLEAN fResetBroken;
BOOLEAN fDisableEncryption;
BOOLEAN fDisableAutoReconnect;
BOOLEAN fDisableCtrlAltDel;
BOOLEAN fDoubleClickDetect;
BOOLEAN fEnableWindowsKey;
BOOLEAN fUsingSavedCreds;
BOOLEAN fMouse;
BOOLEAN fNoAudioPlayback;
BOOLEAN fRemoteConsoleAudio;
BYTE EncryptionLevel;
USHORT ColorDepth;
USHORT ProtocolType;
USHORT HRes;
USHORT VRes;
USHORT ClientProductId;
USHORT OutBufCountHost;
USHORT OutBufCountClient;
USHORT OutBufLength;
ULONG KeyboardLayout;
ULONG MaxConnectionTime;
ULONG MaxDisconnectionTime;
ULONG MaxIdleTime;
ULONG PerformanceFlags;
ULONG KeyboardType;
ULONG KeyboardSubType;
ULONG KeyboardFunctionKey;
ULONG ActiveInputLocale;
ULONG SerialNumber;
ULONG ClientAddressFamily;
ULONG ClientBuildNumber;
ULONG ClientSessionId;
WCHAR WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
WCHAR UserName[WTS_USERNAME_LENGTH + 1];
WCHAR Domain[WTS_DOMAIN_LENGTH + 1];
WCHAR Password[WTS_PASSWORD_LENGTH + 1];
WCHAR ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
WCHAR DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
WCHAR imeFileName[WTS_IMEFILENAME_LENGTH + 1];
WCHAR AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR ClientName[WTS_CLIENTNAME_LENGTH + 1];
WCHAR ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
WCHAR ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
WRDS_SOCKADDR ClientSockAddress;
WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
WRDS_LISTENER_SETTINGS WRdsListenerSettings;
GUID EventLogActivityId;
#if ...
ULONG ContextSize;
#if ...
PBYTE ContextData;
#else
ULONG ContextSize;
#endif
#else
PBYTE ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;
Member
fInheritInitialProgram
Gibt an, ob das anfängliche Programm, das in der Remotedesktopdienste-Shell gestartet werden soll, geerbt wird. Dieser Wert überschreibt den Registrierungswert des Listeners fInheritInitialProgram .
fInheritColorDepth
Gibt an, ob die Farbtiefe des Monitors geerbt werden soll. Dieser Wert überschreibt den Registrierungswert des Listeners fInheritColorDepth .
fHideTitleBar
Gibt an, ob die Titelleiste ausgeblendet ist.
fInheritAutoLogon
Gibt an, ob der Anmeldevorgang automatisch erfolgt. Dieser Wert überschreibt den Registrierungswert des Listeners fInheritAutoLogon .
fMaximizeShell
Gibt an, ob das anfängliche Programm maximiert angezeigt wird. Dieser Wert wird verwendet, wenn fInheritInitialProgram auf TRUE festgelegt ist.
fDisablePNP
Gibt an, ob die PNP-Umleitung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fPasswordIsScPin
Gibt an, dass während des Anmeldeprozesses eine intelligente Karte verwendet wurde. Die smart Karte PIN ist das Kennwort. Dieser Wert wird verwendet, wenn fInheritAutoLogon auf TRUE festgelegt ist.
fPromptForPassword
Gibt an, ob der Benutzer zur Eingabe eines Kennworts aufgefordert werden soll. Wenn dieser Wert TRUE ist, wird der Benutzer auch dann aufgefordert, wenn der Registrierungswert fInheritAutoLogonTRUE ist und die Richtlinie "Immer nach einem Kennwort fragen" nicht festgelegt ist.
fDisableCpm
Gibt an, ob die Druckerzuordnung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fDisableCdm
Gibt an, ob die Laufwerkzuordnung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fDisableCcm
Gibt an, ob die COM-Portzuordnung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fDisableLPT
Gibt an, ob die LPT-Druckerumleitung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fDisableClip
Gibt an, ob die Zwischenablageumleitung aktiviert ist. Dieser Wert wird zunächst anhand der Richtlinieninformationen festgelegt. Wenn Sie den Wert zurücksetzen, wird die Richtlinie überschrieben.
fResetBroken
Gibt die Aktion an, die der Server ausführt, wenn die Verbindungs- oder Leerlauftimer ablaufen oder wenn eine Verbindung aufgrund eines Verbindungsfehlers unterbrochen wird.
false
Die Sitzung wird getrennt, bleibt aber auf dem Server.
true
Die Sitzung wird beendet.
fDisableEncryption
Gibt an, ob die Verschlüsselung für die Kommunikation zwischen Client und Server deaktiviert werden soll.
fDisableAutoReconnect
Gibt an, ob die automatische erneute Verbindung des Clients deaktiviert werden soll.
fDisableCtrlAltDel
Gibt an, ob die Tastenkombination STRG+ALT+ENTF deaktiviert ist.
fDoubleClickDetect
Gibt an, ob der Client doppelklicken kann.
fEnableWindowsKey
Gibt an, ob die Windows-Taste aktiviert ist.
fUsingSavedCreds
Gibt an, ob der Client während des Anmeldevorgangs gespeicherte Anmeldeinformationen verwendet.
fMouse
Gibt an, ob die Mauseingabe aktiviert ist.
fNoAudioPlayback
Gibt an, ob die Audiowiedergabe aktiviert werden soll. Der Wert TRUE gibt keine Audiodaten an.
fRemoteConsoleAudio
Gibt an, ob die Audiowiedergabe auf dem Remotecomputer beibehalten werden soll.
EncryptionLevel
Gibt die Verschlüsselungsebene an.
ColorDepth
Gibt die Farbtiefe des Clientmonitors an. Mögliche Werte finden Sie im ColorDepth-Element der WTS_CLIENT_DISPLAY-Struktur .
ProtocolType
Gibt den Protokolltyp an.
HRes
Gibt die horizontale Auflösung des Clientmonitors an.
VRes
Gibt die vertikale Auflösung des Clientmonitors an.
ClientProductId
Die Produkt-ID der Clientsoftware.
OutBufCountHost
Die Anzahl der Ausgabepuffer auf dem Host.
OutBufCountClient
Die Anzahl der Ausgabepuffer auf dem Client.
OutBufLength
Die Länge der Ausgabepuffer in Bytes.
KeyboardLayout
Gibt das Tastaturlayout an.
MaxConnectionTime
Die maximale Dauer der Remotedesktopdienste-Sitzung in Minuten.
MaxDisconnectionTime
Die maximale Zeitspanne in Minuten, in der eine nicht verbundene Remotedesktopdienste-Sitzung auf dem RD-Sitzungshostserver aktiv bleibt.
MaxIdleTime
Die maximale Zeitspanne in Minuten, für die die Remotedesktopdienste-Sitzung im Leerlauf bleiben kann.
PerformanceFlags
Gibt eine Reihe von Features an, die auf dem Server festgelegt werden können, um die Leistung zu verbessern. Dies kann eine Kombination aus einem oder mehreren der folgenden Werte sein.
WRDS_PERF_DISABLE_NOTHING (0x00000000)
Es sind keine Features deaktiviert.
WRDS_PERF_DISABLE_WALLPAPER (0x00000001)
Das Hintergrundbild auf dem Desktop wird nicht angezeigt.
WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)
Das Ziehen des vollständigen Fensters ist deaktiviert; beim Verschieben des Fensters wird nur die Fenstergliederung angezeigt.
WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)
Menüanimationen sind deaktiviert.
WRDS_PERF_DISABLE_THEMING (0x00000008)
Designs sind deaktiviert.
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)
Aktivieren Sie erweiterte Grafiken.
WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)
Für den Cursor wird kein Schatten angezeigt.
WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)
Das Blinken des Cursors ist deaktiviert.
WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)
Aktivieren Sie die Schriftglättung.
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)
Aktivieren Sie die Desktopkomposition.
KeyboardType
Gibt den Tastaturtyp an.
KeyboardSubType
Gibt den Tastaturuntertyp an.
KeyboardFunctionKey
Gibt den Funktionsschlüssel an.
ActiveInputLocale
Gibt den Eingabegebietsschemabezeichner an. Das niedrige Wort enthält einen Sprachbezeichner, und das hohe Wort enthält ein Gerätehandle zum physischen Layout der Tastatur.
SerialNumber
Die eindeutige Seriennummer des Clientcomputers.
ClientAddressFamily
Die Client-IP-Adressfamilie.
ClientBuildNumber
Die Clientbuildnummer.
ClientSessionId
Die Clientsitzungs-ID.
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
Eine Zeichenfolge, die das Verzeichnis enthält, in dem sich das anfängliche Programm befindet. Dieser Wert wird verwendet, wenn fInheritInitialProgram auf TRUE festgelegt ist.
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
Ein Zeichenfolgenwert, der den Namen des anfänglichen Programms angibt. Dieser Wert wird verwendet, wenn fInheritInitialProgram auf TRUE festgelegt ist.
UserName[WTS_USERNAME_LENGTH + 1]
Eine Zeichenfolge, die den Benutzernamen angibt. Dieser Wert wird verwendet, wenn fInheritAutoLogon auf TRUE festgelegt ist.
Domain[WTS_DOMAIN_LENGTH + 1]
Eine Zeichenfolge, die die Domäne des Benutzers angibt. Dieser Wert wird verwendet, wenn fInheritAutoLogon auf TRUE festgelegt ist.
Password[WTS_PASSWORD_LENGTH + 1]
Eine Zeichenfolge, die das Benutzerkennwort angibt. Dieser Wert wird verwendet, wenn fInheritAutoLogon auf TRUE festgelegt ist.
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
Eine Zeichenfolge, die den Protokollnamen enthält.
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
Eine Zeichenfolge, die den Namen des zu ladenden Anzeigetreibers angibt.
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
Eine Zeichenfolge, die den Namen des Anzeigegeräts angibt.
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
Gibt den Namen des Eingabemethoden-Editors an.
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
Eine Zeichenfolge, die den Namen des zu ladenden Audiotreibers enthält.
ClientName[WTS_CLIENTNAME_LENGTH + 1]
Eine Zeichenfolge, die den vollqualifizierten Namen des Clientcomputers enthält.
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
Eine Zeichenfolge, die die Client-IP-Adresse im gepunkteten Dezimalformat enthält.
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
Das Clientverzeichnis.
Eine Zeichenfolge, die das Clientverzeichnis enthält.
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
Eine Zeichenfolge, die einen Clientproduktbezeichner enthält.
ClientSockAddress
Eine WRDS_SOCKADDR-Struktur , die Socketadresseninformationen enthält.
ClientTimeZone
Eine WRDS_TIME_ZONE_INFORMATION-Struktur , die Informationen zur Clientzeitzone enthält.
WRdsListenerSettings
Eine WRDS_LISTENER_SETTINGS-Struktur , die Listenereinstellungen enthält.
EventLogActivityId
ContextSize
Die Größe des ContextData-Arrays in Bytes.
ContextData
Ein Bytearray, das Kontextdaten für die Verbindung enthält. Die Größe dieses Arrays wird im ContextSize-Member angegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | wtsdefs.h (include Wtsprotocol.h) |