Structure WTSUSERCONFIGA (wtsapi32.h)
Contient des informations de configuration pour un utilisateur sur un contrôleur de domaine ou un serveur hôte de session Bureau à distance (hôte de session Bureau à distance). Cette structure est utilisée par les fonctions WTSQueryUserConfig et WTSSetUserConfig.
Syntaxe
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;
Membres
Source
Valeur du type d’énumération WTS_CONFIG_SOURCE qui spécifie la source des informations de configuration retournées par la fonction WTSQueryUserConfig.
InheritInitialProgram
Valeur qui indique si le client peut spécifier le programme initial. Ce membre peut être l’une des valeurs suivantes.
0
Le client ne peut pas spécifier le programme initial. Au lieu de cela, le programme spécifié par le membre InitialProgram démarre automatiquement lorsque l’utilisateur se connecte au serveur. Le serveur déconnecte l’utilisateur lorsque l’utilisateur quitte ce programme.
1
Le client peut spécifier le programme initial.
AllowLogonTerminalServer
Valeur qui indique si le compte d’utilisateur est autorisé à se connecter à un serveur hôte de session Bureau à distance. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur ne peut pas se connecter.
1
L’utilisateur peut se connecter.
TimeoutSettingsConnections
Durée maximale de la connexion, en millisecondes. Une minute avant l’expiration de la connexion, le serveur informe l’utilisateur de la déconnexion en attente. Lorsque la connexion expire, le serveur effectue l’action spécifiée par l'BrokenTimeoutSettings membre. Chaque fois que l’utilisateur se connecte, le minuteur est réinitialisé. La valeur zéro indique que le minuteur de connexion est désactivé.
TimeoutSettingsDisconnections
Durée maximale, en millisecondes, que le serveur conserve une session déconnectée avant la fin de l’ouverture de session. La valeur zéro indique que le minuteur de déconnexion est désactivé.
TimeoutSettingsIdle
Durée, en millisecondes, pendant laquelle une connexion peut rester inactive. S’il n’existe aucune activité de clavier ou de souris pendant cette période, le serveur effectue l’action spécifiée par le membre BrokenTimeoutSettings. La valeur zéro indique que le minuteur d’inactivité est désactivé.
DeviceClientDrives
Ce membre est réservé.
DeviceClientPrinters
Valeur qui indique si le serveur se connecte automatiquement aux imprimantes clientes précédemment mappées lorsque l’utilisateur se connecte au serveur. Ce membre peut être l’une des valeurs suivantes.
0
Le serveur ne se connecte pas automatiquement aux imprimantes clientes précédemment mappées.
1
Le serveur se connecte automatiquement aux imprimantes clientes précédemment mappées.
ClientDefaultPrinter
Valeur qui indique si l’imprimante cliente est l’imprimante par défaut. Ce membre peut être l’une des valeurs suivantes.
0
L’imprimante cliente n’est pas l’imprimante par défaut.
1
L’imprimante cliente est l’imprimante par défaut.
BrokenTimeoutSettings
Action effectuée par le serveur lorsque les minuteurs de connexion ou d’inactivité expirent, ou lorsqu’une connexion est perdue en raison d’une erreur de connexion. Ce membre peut être l’une des valeurs suivantes.
0
La session est déconnectée, mais elle reste sur le serveur.
1
La session est terminée.
ReconnectSettings
Valeur qui indique comment une session déconnectée pour cet utilisateur peut être reconnectée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut se connecter à n’importe quel ordinateur client pour se reconnecter à une session déconnectée.
1
L’utilisateur doit se connecter à l’ordinateur client à l’origine utilisé pour établir la session déconnectée. Si l’utilisateur se connecte à un autre ordinateur client, l’utilisateur obtient une nouvelle session.
ShadowingSettings
Paramètre de contrôle à distance. Le contrôle à distance permet à un utilisateur de surveiller à distance les opérations à l’écran d’un autre utilisateur. Ce membre peut être l’une des valeurs suivantes.
0
Le contrôle à distance est désactivé.
1
L’utilisateur du contrôle à distance a un contrôle total de la session de l’utilisateur, avec l’autorisation de l’utilisateur.
2
L’utilisateur du contrôle à distance a un contrôle total de la session de l’utilisateur ; l’autorisation de l’utilisateur n’est pas requise.
3
L’utilisateur du contrôle à distance peut afficher la session à distance, avec l’autorisation de l’utilisateur ; l’utilisateur distant ne peut pas contrôler activement la session.
4
L’utilisateur du contrôle à distance peut afficher la session à distance, mais pas contrôler activement la session ; l’autorisation de l’utilisateur n’est pas requise.
TerminalServerRemoteHomeDir
Valeur qui indique si le membre TerminalServerHomeDir contient un chemin d’accès à un répertoire local ou à un partage réseau. Vous ne pouvez pas définir ce membre à l’aide de la fonction WTSSetUserConfig. Ce membre peut être l’une des valeurs suivantes.
0
Le membre terminalServerHomeDir
1
Le membre TerminalServerHomeDir contient un chemin d’accès à un partage réseau, et le membre TerminalServerHomeDirDrive contient une lettre de lecteur à laquelle ce chemin est mappé.
InitialProgram[MAX_PATH + 1]
Chaîne terminée par null qui contient le nom du programme à démarrer immédiatement après que l’utilisateur se connecte au serveur.
WorkDirectory[MAX_PATH + 1]
Chaîne terminée par null qui contient le chemin d’accès du répertoire de travail pour le programme initial.
TerminalServerProfilePath[MAX_PATH + 1]
Chaîne terminée par null qui contient le chemin d’accès du profil affecté à l’utilisateur lorsque l’utilisateur se connecte au serveur. Le répertoire spécifié par le chemin d’accès doit être créé manuellement et doit exister avant l’ouverture de session.
TerminalServerHomeDir[MAX_PATH + 1]
Chaîne terminée par null qui contient le chemin d’accès au dossier d’accueil des sessions des services Bureau à distance de l’utilisateur. Le dossier peut être un dossier local ou un partage réseau.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Chaîne terminée par null qui contient le nom du lecteur (une lettre de lecteur suivie d’un signe deux-points) auquel le chemin d’accès spécifié dans le TerminalServerHomeDir membre est mappé. Ce membre n’est valide que lorsque le membre TerminalServerRemoteHomeDir est défini sur un.
Remarques
Note
L’en-tête wtsapi32.h définit WTSUSERCONFIG comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| d’en-tête | wtsapi32.h |