WTSUSERCONFIGW-Struktur (wtsapi32.h)
Enthält Konfigurationsinformationen für einen Benutzer auf einem Domänencontroller oder Remotedesktopsitzungshostserver (RD-Sitzungshost). Diese Struktur wird von den funktionen WTSQueryUserConfig und WTSSetUserConfig verwendet.
Syntax
typedef struct _WTSUSERCONFIGW {
DWORD Source;
DWORD InheritInitialProgram;
DWORD AllowLogonTerminalServer;
DWORD TimeoutSettingsConnections;
DWORD TimeoutSettingsDisconnections;
DWORD TimeoutSettingsIdle;
DWORD DeviceClientDrives;
DWORD DeviceClientPrinters;
DWORD ClientDefaultPrinter;
DWORD BrokenTimeoutSettings;
DWORD ReconnectSettings;
DWORD ShadowingSettings;
DWORD TerminalServerRemoteHomeDir;
WCHAR InitialProgram[MAX_PATH + 1];
WCHAR WorkDirectory[MAX_PATH + 1];
WCHAR TerminalServerProfilePath[MAX_PATH + 1];
WCHAR TerminalServerHomeDir[MAX_PATH + 1];
WCHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGW, *PWTSUSERCONFIGW;
Angehörige
Source
Ein Wert des WTS_CONFIG_SOURCE Enumerationstyps, der die Quelle der Konfigurationsinformationen angibt, die von der WTSQueryUserConfig-Funktion zurückgegeben werden.
InheritInitialProgram
Ein Wert, der angibt, ob der Client das ursprüngliche Programm angeben kann. Dieses Element kann einer der folgenden Werte sein:
0
Der Client kann das ursprüngliche Programm nicht angeben. Stattdessen wird das vom InitialProgram Member angegebene Programm automatisch gestartet, wenn sich der Benutzer beim Server anmeldet. Der Server protokolliert den Benutzer aus, wenn der Benutzer das Programm beendet.
1
Der Client kann das anfängliche Programm angeben.
AllowLogonTerminalServer
Ein Wert, der angibt, ob sich das Benutzerkonto bei einem RD-Sitzungshostserver anmelden darf. Dieses Element kann einer der folgenden Werte sein:
0
Der Benutzer kann sich nicht anmelden.
1
Der Benutzer kann sich anmelden.
TimeoutSettingsConnections
Die maximale Verbindungsdauer in Millisekunden. Eine Minute vor Ablauf der Verbindung benachrichtigt der Server den Benutzer über die ausstehende Verbindung. Wenn die Verbindung zu einem Timeout führt der Server die vom BrokenTimeoutSettings Member angegebene Aktion aus. Jedes Mal, wenn sich der Benutzer anmeldet, wird der Timer zurückgesetzt. Ein Wert von Null gibt an, dass der Verbindungstimer deaktiviert ist.
TimeoutSettingsDisconnections
Die maximale Dauer in Millisekunden, für die der Server eine getrennte Sitzung beibehält, bevor die Anmeldung beendet wird. Ein Wert von Null gibt an, dass der Trennzeitgeber deaktiviert ist.
TimeoutSettingsIdle
Die Zeitspanne in Millisekunden, die eine Verbindung im Leerlauf bleiben kann. Wenn für diesen Zeitraum keine Tastatur- oder Mausaktivität vorhanden ist, führt der Server die vom BrokenTimeoutSettings Member angegebene Aktion aus. Ein Wert von Null gibt an, dass der Leerlauftimer deaktiviert ist.
DeviceClientDrives
Dieses Mitglied ist reserviert.
DeviceClientPrinters
Ein Wert, der angibt, ob der Server automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern herstellt, wenn sich der Benutzer beim Server anmeldet. Dieses Element kann einer der folgenden Werte sein:
0
Der Server stellt keine automatische Verbindung mit zuvor zugeordneten Clientdruckern her.
1
Der Server stellt automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern herstellt.
ClientDefaultPrinter
Ein Wert, der angibt, 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.
BrokenTimeoutSettings
Die Aktion, die der Server ausführt, wenn die Verbindung oder der Leerlaufzeitgeber ablaufen, oder wenn eine Verbindung aufgrund eines Verbindungsfehlers verloren geht. Dieses Element kann einer der folgenden Werte sein:
0
Die Sitzung ist getrennt, bleibt aber auf dem Server.
1
Die Sitzung wird beendet.
ReconnectSettings
Ein Wert, der angibt, wie eine getrennte Sitzung für diesen Benutzer erneut verbunden werden kann. Dieses Element kann einer der folgenden Werte sein:
0
Der Benutzer kann sich bei jedem Clientcomputer anmelden, um die Verbindung mit einer getrennten Sitzung wiederherzustellen.
1
Der Benutzer muss sich ursprünglich bei dem Clientcomputer anmelden, der ursprünglich zum Einrichten der getrennten Sitzung verwendet wurde. Wenn sich der Benutzer auf einem anderen Clientcomputer anmeldet, erhält der Benutzer eine neue Sitzung.
ShadowingSettings
Die Einstellung für die Fernbedienung. Die Remotesteuerung ermöglicht es einem Benutzer, die Bildschirmvorgänge eines anderen Benutzers remote zu überwachen. 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.
TerminalServerRemoteHomeDir
Ein Wert, der angibt, ob das TerminalServerHomeDir Mitglied einen Pfad zu einem lokalen Verzeichnis oder einer Netzwerkfreigabe enthält. Sie können dieses Element nicht mithilfe der funktion WTSSetUserConfig festlegen. Dieses Element kann einer der folgenden Werte sein:
0
Der TerminalServerHomeDir Member enthält einen Pfad zu einem lokalen Verzeichnis.
1
Der TerminalServerHomeDir- Member enthält einen Pfad zu einer Netzwerkfreigabe, und das TerminalServerHomeDirDrive Member enthält einen Laufwerkbuchstaben, dem dieser Pfad zugeordnet ist.
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.
WorkDirectory[MAX_PATH + 1]
Eine mit Null beendete Zeichenfolge, die den Pfad des Arbeitsverzeichnisses für das erste Programm enthält.
TerminalServerProfilePath[MAX_PATH + 1]
Eine mit Null beendete Zeichenfolge, die den Profilpfad enthält, der dem Benutzer zugewiesen ist, wenn der Benutzer eine Verbindung mit dem Server herstellt. Das vom Pfad angegebene Verzeichnis muss manuell erstellt werden und muss vor der Anmeldung vorhanden sein.
TerminalServerHomeDir[MAX_PATH + 1]
Eine mit Null beendete Zeichenfolge, die den Pfad zum Startordner der Remotedesktopdienstesitzungen des Benutzers enthält. Der Ordner kann ein lokaler Ordner oder eine Netzwerkfreigabe sein.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Eine mit Null beendete Zeichenfolge, die den Laufwerknamen (ein Laufwerkbuchstaben gefolgt von einem Doppelpunkt) enthält, dem der im TerminalServerHomeDir Member angegebene Pfad zugeordnet ist. Dieses Element ist nur gültig, wenn das TerminalServerRemoteHomeDir- Mitglied auf ein Element festgelegt ist.
Bemerkungen
Anmerkung
Der wtsapi32.h-Header definiert WTSUSERCONFIG 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 |