WTSUSERCONFIGA-Struktur (wtsapi32.h)
Enthält Konfigurationsinformationen für einen Benutzer auf einem Domänencontroller oder Remotedesktop-Sitzungshostserver (RD-Sitzungshost). Diese Struktur wird von den Funktionen WTSQueryUserConfig und WTSSetUserConfig verwendet.
Syntax
typedef struct _WTSUSERCONFIGA {
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;
CHAR InitialProgram[MAX_PATH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR TerminalServerProfilePath[MAX_PATH + 1];
CHAR TerminalServerHomeDir[MAX_PATH + 1];
CHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;
Member
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 anfängliche Programm angeben kann. Dieser Member kann einer der folgenden Werte sein.
0
Der Client kann das anfängliche Programm nicht angeben. Stattdessen wird das vom InitialProgram-Member angegebene Programm automatisch gestartet, wenn sich der Benutzer beim Server anmeldet. Der Server meldet den Benutzer ab, 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. Dieser Member 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 Trennung. Wenn für die Verbindung ein Timeout auftritt, führt der Server die vom BrokenTimeoutSettings-Element angegebene Aktion aus. Bei jeder Anmeldung des Benutzers wird der Timer zurückgesetzt. Der Wert 0 (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. Der Wert 0 (null) gibt an, dass der Timer für die Trennung 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-Element angegebene Aktion aus. Der Wert 0 (null) gibt an, dass der Leerlauftimer deaktiviert ist.
DeviceClientDrives
Dieser Member 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. Dieser Member kann einer der folgenden Werte sein.
0
Der Server stellt nicht automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern her.
1
Der Server stellt automatisch eine Verbindung mit zuvor zugeordneten Clientdruckern her.
ClientDefaultPrinter
Ein -Wert, der angibt, ob der Clientdrucker der Standarddrucker ist. Dieser Member 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 Verbindungs- oder Leerlauftimer ablaufen oder wenn eine Verbindung aufgrund eines Verbindungsfehlers unterbrochen wird. Dieser Member kann einer der folgenden Werte sein.
0
Die Sitzung wird getrennt, bleibt aber auf dem Server.
1
Die Sitzung wird beendet.
ReconnectSettings
Ein -Wert, der angibt, wie eine getrennte Sitzung für diesen Benutzer wiederhergestellt werden kann. Dieser Member kann einer der folgenden Werte sein.
0
Der Benutzer kann sich bei einem beliebigen Clientcomputer anmelden, um wieder eine Verbindung mit einer getrennten Sitzung herzustellen.
1
Der Benutzer muss sich bei dem Clientcomputer anmelden, der ursprünglich zum Einrichten der getrennten Sitzung verwendet wurde. Wenn sich der Benutzer bei einem anderen Clientcomputer anmeldet, erhält der Benutzer eine neue Sitzung.
ShadowingSettings
Die Remotesteuerungseinstellung. Die Remotesteuerung ermöglicht es einem Benutzer, die Bildschirmvorgänge eines anderen Benutzers remote zu überwachen. Dieser Member kann einer der folgenden Werte sein.
0
Die Remotesteuerung ist deaktiviert.
1
Der Benutzer der Remotesteuerung hat mit der Berechtigung des Benutzers die vollständige Kontrolle über die Sitzung 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 Remotesteuerung kann die Sitzung mit der Berechtigung des Benutzers remote anzeigen. Der Remotebenutzer kann die Sitzung nicht aktiv steuern.
4
Der Benutzer der Remotesteuerung kann die Sitzung remote anzeigen, aber nicht aktiv steuern. die Berechtigung des Benutzers ist nicht erforderlich.
TerminalServerRemoteHomeDir
Ein -Wert, der angibt, ob das TerminalServerHomeDir-Element einen Pfad zu einem lokalen Verzeichnis oder einer Netzwerkfreigabe enthält. Sie können diesen Member nicht mithilfe der Funktion WTSSetUserConfig festlegen. Dieser Member kann einer der folgenden Werte sein.
0
Das TerminalServerHomeDir-Element enthält einen Pfad zu einem lokalen Verzeichnis.
1
Das TerminalServerHomeDir-Element enthält einen Pfad zu einer Netzwerkfreigabe, und das TerminalServerHomeDirDrive-Element enthält einen Laufwerkbuchstaben, dem dieser Pfad zugeordnet ist.
InitialProgram[MAX_PATH + 1]
Eine Zeichenfolge mit NULL-Beendigung, die den Namen des Programms enthält, das unmittelbar nach der Anmeldung des Benutzers beim Server gestartet werden soll.
WorkDirectory[MAX_PATH + 1]
Eine NULL-Zeichenfolge, die den Pfad des Arbeitsverzeichnisses für das anfängliche Programm enthält.
TerminalServerProfilePath[MAX_PATH + 1]
Eine NULL-beendete Zeichenfolge, die den Profilpfad enthält, der dem Benutzer zugewiesen wird, wenn der Benutzer eine Verbindung mit dem Server herstellt. Das durch den Pfad angegebene Verzeichnis muss manuell erstellt werden und muss vor der Anmeldung vorhanden sein.
TerminalServerHomeDir[MAX_PATH + 1]
Eine NULL-beendete Zeichenfolge, die den Pfad zum Basisordner der Remotedesktopdienste-Sitzungen des Benutzers enthält. Der Ordner kann ein lokaler Ordner oder eine Netzwerkfreigabe sein.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Eine NULL-endende Zeichenfolge, die den Laufwerksnamen (ein Laufwerkbuchstabe gefolgt von einem Doppelpunkt) enthält, dem der im TerminalServerHomeDir-Element angegebene Pfad zugeordnet ist. Dieser Member ist nur gültig, wenn das TerminalServerRemoteHomeDir-Element auf ein Element festgelegt ist.
Hinweise
Hinweis
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
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Kopfzeile | wtsapi32.h |