Freigeben über


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)