Freigeben über


WTS_CONFIG_CLASS-Enumeration (wtsapi32.h)

Enthält Werte, die den Typ der Benutzerkonfigurationsinformationen angeben, die in einem Aufruf der Funktionen WTSQueryUserConfig und WTSSetUserConfig festgelegt oder abgerufen werden sollen.

Syntax

typedef enum _WTS_CONFIG_CLASS {
  WTSUserConfigInitialProgram,
  WTSUserConfigWorkingDirectory,
  WTSUserConfigfInheritInitialProgram,
  WTSUserConfigfAllowLogonTerminalServer,
  WTSUserConfigTimeoutSettingsConnections,
  WTSUserConfigTimeoutSettingsDisconnections,
  WTSUserConfigTimeoutSettingsIdle,
  WTSUserConfigfDeviceClientDrives,
  WTSUserConfigfDeviceClientPrinters,
  WTSUserConfigfDeviceClientDefaultPrinter,
  WTSUserConfigBrokenTimeoutSettings,
  WTSUserConfigReconnectSettings,
  WTSUserConfigModemCallbackSettings,
  WTSUserConfigModemCallbackPhoneNumber,
  WTSUserConfigShadowingSettings,
  WTSUserConfigTerminalServerProfilePath,
  WTSUserConfigTerminalServerHomeDir,
  WTSUserConfigTerminalServerHomeDirDrive,
  WTSUserConfigfTerminalServerRemoteHomeDir,
  WTSUserConfigUser
} WTS_CONFIG_CLASS;

Konstanten

 
WTSUserConfigInitialProgram
Eine NULL-beendete Zeichenfolge, die den Pfad des anfänglichen Programms enthält, das von Remotedesktopdiensten ausgeführt wird, wenn
Benutzer meldet sich an.

Wenn der Wert WTSUserConfigfInheritInitialProgram 1 ist, kann das anfängliche Programm sein.
jedes vom Client angegebene Programm.
WTSUserConfigWorkingDirectory
Eine NULL-Zeichenfolge, die den Pfad des Arbeitsverzeichnisses für das anfängliche Programm enthält.
WTSUserConfigfInheritInitialProgram
Ein Wert, der angibt, ob der Client das anfängliche Programm angeben kann.














WertBedeutung

0


Der Client kann das anfängliche Programm nicht angeben. Stattdessen
WTSUserConfigInitialProgram-Zeichenfolge identifiziert ein anfängliches Programm, das ausgeführt wird
automatisch, wenn sich der Benutzer bei einem Remotecomputer anmeldet. Remotedesktopdienste protokolliert den Benutzer ab, wenn der Benutzer
beendet dieses Programm.


1


Der Client kann das anfängliche Programm angeben.

WTSUserConfigfAllowLogonTerminalServer
Ein Wert, der angibt, ob sich das Benutzerkonto bei einem RD-Sitzungshostserver anmelden darf.














WertBedeutung

0


Der Benutzer kann sich nicht anmelden.


1


Der Benutzer kann sich anmelden.

WTSUserConfigTimeoutSettingsConnections
Ein DWORD-Wert , der die maximale Verbindungsdauer in Millisekunden angibt.
Eine Minute vor Ablauf des Verbindungstimeoutintervalls wird der Benutzer über die ausstehende Trennung benachrichtigt.
Die Sitzung des Benutzers wird getrennt oder beendet, je nach
WTSUserConfigBrokenTimeoutSettings-Wert . Jedes Mal, wenn sich der Benutzer anmeldet, lautet der Timer
Zurücksetzen. Der Wert 0 gibt an, dass der Verbindungstimer deaktiviert ist.
WTSUserConfigTimeoutSettingsDisconnections
Ein DWORD-Wert , der die maximale Dauer in Millisekunden angibt, die ein
Der RD-Sitzungshostserver behält eine getrennte Sitzung bei, bevor die Anmeldung beendet wird. Der Wert 0 gibt an, dass
Der Verbindungstimer ist deaktiviert.
WTSUserConfigTimeoutSettingsIdle
Ein DWORD-Wert , der die maximale Leerlaufzeit in Millisekunden angibt. Wenn vorhanden
ist keine Tastatur- oder Mausaktivität für das angegebene Intervall, die Sitzung des Benutzers wird getrennt oder beendet.
abhängig vom Wert WTSUserConfigBrokenTimeoutSettings . Ein Wert von 0
gibt an, dass der Leerlauftimer deaktiviert ist.
WTSUserConfigfDeviceClientDrives
Diese Konstante wird derzeit nicht von Remotedesktopdiensten verwendet.

Ein Wert, der angibt, ob der RD-Sitzungshostserver automatisch wieder eingerichtet wird.
Clientlaufwerkzuordnungen bei der Anmeldung.














WertBedeutung

0


Der Server stellt nicht automatisch eine Verbindung mit zuvor zugeordneten Clientlaufwerken her.


1


Der Server stellt bei der Anmeldung automatisch eine Verbindung mit zuvor zugeordneten Clientlaufwerken her.

WTSUserConfigfDeviceClientPrinters
RDP 5.0- und höher-Clients: Ein Wert, der angibt, ob der RD-Sitzungshostserver
Stellt die Clientdruckerzuordnungen bei der Anmeldung automatisch wieder her.














WertBedeutung

0


Der Server stellt nicht automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern her.


1


Der Server stellt bei der Anmeldung automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern her.

WTSUserConfigfDeviceClientDefaultPrinter
RDP 5.0- und höher-Clients: Ein Wert, der angibt, ob der Clientdrucker
ist der Standarddrucker.














WertBedeutung

0


Der Clientdrucker ist nicht der Standarddrucker.


1


Der Clientdrucker ist der Standarddrucker.

WTSUserConfigBrokenTimeoutSettings
Ein Wert, der angibt, was geschieht, wenn die Verbindung oder der Leerlaufzeitpunkt abläuft oder wenn eine Verbindung verloren geht.
aufgrund eines Verbindungsfehlers.














WertBedeutung

0


Die Sitzung wird getrennt.


1


Die Sitzung wird beendet.

WTSUserConfigReconnectSettings
Ein Wert, der angibt, wie eine getrennte Sitzung für diesen Benutzer wiederhergestellt werden kann.














WertBedeutung

0


Der Benutzer kann sich bei jedem Clientcomputer anmelden, um wieder eine Verbindung mit einer getrennten Sitzung herzustellen.


1


Der Benutzer kann wieder eine Verbindung mit einer getrennten Sitzung herstellen, indem er sich bei dem Clientcomputer anmeldet, der zum Einrichten verwendet wird.
die nicht verbundene Sitzung. Wenn sich der Benutzer von einem anderen Clientcomputer aus anmeldet, erhält der Benutzer eine neue Anmeldung.
Sitzung.

WTSUserConfigModemCallbackSettings
Diese Konstante wird derzeit nicht von Remotedesktopdiensten verwendet.

Ein Wert, der die Konfiguration für DFÜ-Verbindungen angibt, in denen
Der RD-Sitzungshostserver reagiert nicht mehr und ruft dann den Client zurück, um die Verbindung herzustellen.


















WertBedeutung

0


Rückrufverbindungen sind deaktiviert.


1


Der Server fordert den Benutzer auf, eine Telefonnummer einzugeben, und ruft den Benutzer unter dieser Telefonnummer zurück. Sie haben folgende Möglichkeiten:
Verwenden Sie den WtSUserConfigModemCallbackPhoneNumber-Wert , um ein Standardtelefon anzugeben.
überprüfen.


2


Der Server ruft den Benutzer automatisch unter der von angegebenen Telefonnummer zurück.
WTSUserConfigModemCallbackPhoneNumber-Wert .

WTSUserConfigModemCallbackPhoneNumber
Diese Konstante wird derzeit nicht von Remotedesktopdiensten verwendet.

Eine NULL-endende Zeichenfolge, die die Telefonnummer enthält, die für den Rückruf verwendet werden soll.
Netzwerkverbindungen.
WTSUserConfigShadowingSettings
RDP 5.0- und höher-Clients: Ein Wert, der angibt, ob die Benutzersitzung
kann beschatten. Mit shadowing kann ein Benutzer die Bildschirmvorgänge eines anderen Benutzers remote überwachen.


























WertBedeutung

0


Deaktivieren


1


Eingabe aktivieren, benachrichtigen


2


Eingabe aktivieren, keine Benachrichtigung


3


Keine Eingabe aktivieren, benachrichtigen


4


Keine Eingabe, keine Benachrichtigung aktivieren

WTSUserConfigTerminalServerProfilePath
Eine NULL-endende Zeichenfolge, die den Pfad des Benutzerprofils für die Anmeldung des RD-Sitzungshostservers enthält. Das Verzeichnis.
der Pfad identifiziert, muss manuell erstellt werden und muss vor der Anmeldung vorhanden sein.
WTSSetUserConfig erstellt das Verzeichnis nicht.
, wenn es noch nicht vorhanden ist.
WTSUserConfigTerminalServerHomeDir
Eine NULL-endende Zeichenfolge, die den Pfad des Stammverzeichnisses des Benutzers für die Anmeldung des RD-Sitzungshostservers enthält. Diese
string kann einen lokalen Pfad oder einen UNC-Pfad (\ComputerName\Share\Path) angeben. Weitere Informationen finden Sie unter
WTSUserConfigfTerminalServerRemoteHomeDir.
WTSUserConfigTerminalServerHomeDirDrive
Eine NULL-endende Zeichenfolge, die einen Laufwerksnamen (einen Laufwerkbuchstaben gefolgt von einem Doppelpunkt) enthält, an den die UNC
Der in der WTSUserConfigTerminalServerHomeDir-Zeichenfolge angegebene Pfad wird zugeordnet. Weitere Informationen finden Sie unter
WTSUserConfigfTerminalServerRemoteHomeDir.
WTSUserConfigfTerminalServerRemoteHomeDir
Ein -Wert, der angibt, ob das Stammverzeichnis des Benutzers für die Anmeldung des RD-Sitzungshostservers ein lokaler Pfad oder ein
zugeordneter Laufwerkbuchstabe. Beachten Sie, dass dieser Wert nicht mit verwendet werden kann.
WTSSetUserConfig.














WertBedeutung

0


Die WTSUserConfigTerminalServerHomeDir-Zeichenfolge enthält den lokalen Pfad des
Stammverzeichnis des Remotedesktop-Sitzungshostservers


1


Die WTSUserConfigTerminalServerHomeDir-Zeichenfolge enthält den UNC-Pfad des
Stammverzeichnis des RD-Sitzungshostservers und das
WTSUserConfigTerminalServerHomeDirDrive-Zeichenfolge enthält einen Laufwerkbuchstaben, an den
Der UNC-Pfad wird zugeordnet.

WTSUserConfigUser
Eine WTSUSERCONFIG-Struktur , die Konfigurationsdaten für die Sitzung enthält.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile wtsapi32.h

Weitere Informationen

WTSQueryUserConfig

WTSSetUserConfig