Partager via


énumération WTS_CONFIG_CLASS (wtsapi32.h)

Contient des valeurs qui indiquent le type d’informations de configuration utilisateur à définir ou récupérer dans un appel aux fonctions WTSQueryUserConfig et WTSSetUserConfig .

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;

Constantes

 
WTSUserConfigInitialProgram
Chaîne terminée par null qui contient le chemin du programme initial exécuté par les services Bureau à distance lorsque le
l’utilisateur se connecte.

Si la valeur WTSUserConfigfInheritInitialProgram est 1, le programme initial peut être
n’importe quel programme spécifié par le client.
WTSUserConfigWorkingDirectory
Chaîne terminée par null qui contient le chemin du répertoire de travail du programme initial.
WTSUserConfigfInheritInitialProgram
Valeur qui indique si le client peut spécifier le programme initial.














ValeurSignification

0


Le client ne peut pas spécifier le programme initial. Au lieu de cela, le
La chaîne WTSUserConfigInitialProgram identifie un programme initial qui s’exécute
automatiquement lorsque l’utilisateur se connecte à un ordinateur distant. Les services Bureau à distance déconnectent l’utilisateur lorsque l’utilisateur
quitte ce programme.


1


Le client peut spécifier le programme initial.

WTSUserConfigfAllowLogonTerminalServer
Valeur qui indique si le compte d’utilisateur est autorisé à se connecter à un serveur hôte de session Bureau à distance.














ValeurSignification

0


L’utilisateur ne peut pas se connecter.


1


L’utilisateur peut se connecter.

WTSUserConfigTimeoutSettingsConnections
Valeur DWORD qui spécifie la durée de connexion maximale, en millisecondes.
Une minute avant l’expiration de l’intervalle de délai de connexion, l’utilisateur est averti de la déconnexion en attente.
La session de l’utilisateur est déconnectée ou terminée en fonction du
Valeur WTSUserConfigBrokenTimeoutSettings . Chaque fois que l’utilisateur se connecte, le minuteur est
Réinitialiser. La valeur zéro indique que le minuteur de connexion est désactivé.
WTSUserConfigTimeoutSettingsDisconnections
Valeur DWORD qui spécifie la durée maximale, en millisecondes, qu’un
Le serveur hôte de session Bureau à distance conserve une session déconnectée avant la fin de l’ouverture de session. La valeur zéro indique que le
le minuteur de déconnexion est désactivé.
WTSUserConfigTimeoutSettingsIdle
Valeur DWORD qui spécifie le temps d’inactivité maximal, en millisecondes. Si présent
n’est aucune activité du clavier ou de la souris pour l’intervalle spécifié, la session de l’utilisateur est déconnectée ou terminée
selon la valeur WTSUserConfigBrokenTimeoutSettings . Valeur zéro
indique que le minuteur d’inactivité est désactivé.
WTSUserConfigfDeviceClientDrives
Cette constante n’est actuellement pas utilisée par les services Bureau à distance.

Valeur qui indique si le serveur hôte de session Bureau à distance se rétablit automatiquement
mappages de lecteur client lors de l’ouverture de session.














ValeurSignification

0


Le serveur ne se connecte pas automatiquement aux lecteurs clients précédemment mappés.


1


Le serveur se connecte automatiquement aux lecteurs clients précédemment mappés lors de l’ouverture de session.

WTSUserConfigfDeviceClientPrinters
Clients RDP 5.0 et ultérieur : valeur qui indique si le serveur hôte de session Bureau à distance
rétablit automatiquement les mappages d’imprimantes clientes lors de l’ouverture de session.














ValeurSignification

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 lors de l’ouverture de session.

WTSUserConfigfDeviceClientDefaultPrinter
Clients RDP 5.0 et ultérieur : valeur qui indique si l’imprimante cliente
est l’imprimante par défaut.














ValeurSignification

0


L’imprimante cliente n’est pas l’imprimante par défaut.


1


L’imprimante cliente est l’imprimante par défaut.

WTSUserConfigBrokenTimeoutSettings
Valeur qui indique ce qui se passe quand la connexion ou les minuteurs inactifs expirent ou quand une connexion est perdue
en raison d’une erreur de connexion.














ValeurSignification

0


La session est déconnectée.


1


La session est terminée.

WTSUserConfigReconnectSettings
Valeur qui indique comment une session déconnectée pour cet utilisateur peut être reconnectée.














ValeurSignification

0


L’utilisateur peut se connecter à n’importe quel ordinateur client pour se reconnecter à une session déconnectée.


1


L’utilisateur peut se reconnecter à une session déconnectée en se connectant à l’ordinateur client utilisé pour établir
session déconnectée. Si l’utilisateur se connecte à partir d’un autre ordinateur client, il obtient une nouvelle ouverture de session
Session.

WTSUserConfigModemCallbackSettings
Cette constante n’est actuellement pas utilisée par les services Bureau à distance.

Valeur qui indique la configuration des connexions d’accès à distance dans lesquelles
Le serveur hôte de session Bureau à distance cesse de répondre, puis rappelle le client pour établir la connexion.


















ValeurSignification

0


Les connexions de rappel sont désactivées.


1


Le serveur invite l’utilisateur à entrer un numéro de téléphone et l’appelle à nouveau à ce numéro de téléphone. Vous pouvez :
utiliser la valeur WTSUserConfigModemCallbackPhoneNumber pour spécifier un téléphone par défaut
le plus élevé.


2


Le serveur appelle automatiquement l’utilisateur au numéro de téléphone spécifié par le
Valeur WTSUserConfigModemCallbackPhoneNumber .

WTSUserConfigModemCallbackPhoneNumber
Cette constante n’est actuellement pas utilisée par les services Bureau à distance.

Chaîne terminée par null qui contient le numéro de téléphone à utiliser pour le rappel
connexions réseau sécurisées.
WTSUserConfigShadowingSettings
Clients RDP 5.0 et ultérieur : valeur qui indique si la session utilisateur
peut être ombré. L’ombre permet à un utilisateur de surveiller à distance les opérations à l’écran d’un autre utilisateur.


























ValeurSignification

0


Désactiver


1


Activer l’entrée, notifier


2


Activer l’entrée, aucune notification


3


Activer aucune entrée, notifier


4


Activer aucune entrée, aucune notification

WTSUserConfigTerminalServerProfilePath
Chaîne terminée par null qui contient le chemin d’accès du profil de l’utilisateur pour l’ouverture de session Bureau à distance au serveur hôte. Répertoire
Le chemin d’identification doit être créé manuellement et doit exister avant l’ouverture de session.
WTSSetUserConfig ne crée pas le répertoire
si elle n’existe pas déjà.
WTSUserConfigTerminalServerHomeDir
Chaîne terminée par null qui contient le chemin d’accès du répertoire racine de l’utilisateur pour l’ouverture de session Bureau à distance au serveur hôte. Cette
string peut spécifier un chemin d’accès local ou un chemin UNC (\ComputerName\Share\Path). Pour plus d'informations, consultez la rubrique
WTSUserConfigfTerminalServerRemoteHomeDir.
WTSUserConfigTerminalServerHomeDirDrive
Chaîne terminée par null qui contient un nom de lecteur (une lettre de lecteur suivie d’un signe deux-points) auquel l’UNC
le chemin spécifié dans la chaîne WTSUserConfigTerminalServerHomeDir est mappé. Pour plus d'informations, consultez la rubrique
WTSUserConfigfTerminalServerRemoteHomeDir.
WTSUserConfigfTerminalServerRemoteHomeDir
Valeur qui indique si le répertoire racine de l’utilisateur pour la connexion au serveur hôte de session Bureau à distance est un chemin d’accès local ou un
lettre de lecteur mappée. Notez que cette valeur ne peut pas être utilisée avec
WTSSetUserConfig.














ValeurSignification

0


La chaîne WTSUserConfigTerminalServerHomeDir contient le chemin d’accès local du
répertoire racine de connexion du serveur hôte de session Bureau à distance de l’utilisateur.


1


La chaîne WTSUserConfigTerminalServerHomeDir contient le chemin UNC du
le répertoire racine de connexion du serveur hôte de session Bureau à distance de l’utilisateur, et le
La chaîne WTSUserConfigTerminalServerHomeDirDrive contient une lettre de lecteur à laquelle
le chemin UNC est mappé.

WTSUserConfigUser
Structure WTSUSERCONFIG qui contient des données de configuration pour la session.

Windows Server 2008 et Windows Vista : Cette valeur n’est pas prise en charge.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
En-tête wtsapi32.h

Voir aussi

WTSQueryUserConfig

WTSSetUserConfig