structure WRDS_CONNECTION_SETTINGS_1 (wtsdefs.h)

Contient des informations de paramètre de connexion pour une session à distance.

Syntaxe

typedef struct _WRDS_CONNECTION_SETTINGS_1 {
  BOOLEAN                    fInheritInitialProgram;
  BOOLEAN                    fInheritColorDepth;
  BOOLEAN                    fHideTitleBar;
  BOOLEAN                    fInheritAutoLogon;
  BOOLEAN                    fMaximizeShell;
  BOOLEAN                    fDisablePNP;
  BOOLEAN                    fPasswordIsScPin;
  BOOLEAN                    fPromptForPassword;
  BOOLEAN                    fDisableCpm;
  BOOLEAN                    fDisableCdm;
  BOOLEAN                    fDisableCcm;
  BOOLEAN                    fDisableLPT;
  BOOLEAN                    fDisableClip;
  BOOLEAN                    fResetBroken;
  BOOLEAN                    fDisableEncryption;
  BOOLEAN                    fDisableAutoReconnect;
  BOOLEAN                    fDisableCtrlAltDel;
  BOOLEAN                    fDoubleClickDetect;
  BOOLEAN                    fEnableWindowsKey;
  BOOLEAN                    fUsingSavedCreds;
  BOOLEAN                    fMouse;
  BOOLEAN                    fNoAudioPlayback;
  BOOLEAN                    fRemoteConsoleAudio;
  BYTE                       EncryptionLevel;
  USHORT                     ColorDepth;
  USHORT                     ProtocolType;
  USHORT                     HRes;
  USHORT                     VRes;
  USHORT                     ClientProductId;
  USHORT                     OutBufCountHost;
  USHORT                     OutBufCountClient;
  USHORT                     OutBufLength;
  ULONG                      KeyboardLayout;
  ULONG                      MaxConnectionTime;
  ULONG                      MaxDisconnectionTime;
  ULONG                      MaxIdleTime;
  ULONG                      PerformanceFlags;
  ULONG                      KeyboardType;
  ULONG                      KeyboardSubType;
  ULONG                      KeyboardFunctionKey;
  ULONG                      ActiveInputLocale;
  ULONG                      SerialNumber;
  ULONG                      ClientAddressFamily;
  ULONG                      ClientBuildNumber;
  ULONG                      ClientSessionId;
  WCHAR                      WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
  WCHAR                      InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
  WCHAR                      UserName[WTS_USERNAME_LENGTH + 1];
  WCHAR                      Domain[WTS_DOMAIN_LENGTH + 1];
  WCHAR                      Password[WTS_PASSWORD_LENGTH + 1];
  WCHAR                      ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
  WCHAR                      DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
  WCHAR                      DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
  WCHAR                      imeFileName[WTS_IMEFILENAME_LENGTH + 1];
  WCHAR                      AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
  WCHAR                      ClientName[WTS_CLIENTNAME_LENGTH + 1];
  WCHAR                      ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
  WCHAR                      ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
  WCHAR                      ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
  WRDS_SOCKADDR              ClientSockAddress;
  WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
  WRDS_LISTENER_SETTINGS     WRdsListenerSettings;
  GUID                       EventLogActivityId;
#if ...
  ULONG                      ContextSize;
#if ...
  PBYTE                      ContextData;
#else
  ULONG                      ContextSize;
#endif
#else
  PBYTE                      ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;

Membres

fInheritInitialProgram

Spécifie si le programme initial à démarrer dans l’interpréteur de commande Services Bureau à distance est hérité. Cette valeur remplace la valeur de Registre de l’écouteur fInheritInitialProgram .

fInheritColorDepth

Spécifie s’il faut hériter de la profondeur de couleur du moniteur. Cette valeur remplace la valeur de Registre de l’écouteur fInheritColorDepth .

fHideTitleBar

Spécifie si la barre de titre est masquée.

fInheritAutoLogon

Spécifie si le processus d’ouverture de session est automatique. Cette valeur remplace la valeur de Registre de l’écouteur fInheritAutoLogon .

fMaximizeShell

Spécifie si le programme initial est affiché agrandi. Cette valeur est utilisée si fInheritInitialProgram a la valeur TRUE.

fDisablePNP

Spécifie si la redirection PNP est activée. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fPasswordIsScPin

Spécifie qu’un carte intelligent a été utilisé pendant le processus d’ouverture de session. Le code confidentiel intelligent carte est le mot de passe. Cette valeur est utilisée si fInheritAutoLogon a la valeur TRUE.

fPromptForPassword

Spécifie s’il faut inviter l’utilisateur à entrer un mot de passe. Si cette valeur est TRUE, l’utilisateur est invité même si la valeur de Registre fInheritAutoLogon est TRUE et que la stratégie « Toujours demander un mot de passe » n’est pas définie.

fDisableCpm

Spécifie si le mappage d’imprimante est activé. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fDisableCdm

Spécifie si le mappage de lecteur est activé. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fDisableCcm

Spécifie si le mappage de ports COM est activé. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fDisableLPT

Spécifie si la redirection de l’imprimante LPT est activée. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fDisableClip

Spécifie si la redirection du Presse-papiers est activée. Cette valeur est initialement définie à partir des informations de stratégie. Si vous réinitialisez la valeur, la stratégie sera remplacée.

fResetBroken

Spécifie l’action que le serveur effectue lorsque la connexion ou les minuteurs inactifs expirent, ou lorsqu’une connexion est perdue en raison d’une erreur de connexion.

FALSE

La session est déconnectée, mais elle reste sur le serveur.

TRUE

La session est terminée.

fDisableEncryption

Spécifie s’il faut désactiver le chiffrement pour la communication entre le client et le serveur.

fDisableAutoReconnect

Spécifie s’il faut désactiver la reconnexion automatique du client.

fDisableCtrlAltDel

Spécifie si le raccourci clavier Ctrl+Alt+Supprimer est désactivé.

fDoubleClickDetect

Spécifie si le client peut double-cliquer.

fEnableWindowsKey

Spécifie si la clé Windows est activée.

fUsingSavedCreds

Spécifie si le client utilise les informations d’identification enregistrées pendant le processus d’ouverture de session.

fMouse

Spécifie si l’entrée de la souris est activée.

fNoAudioPlayback

Spécifie s’il faut activer la lecture audio. La valeur TRUE ne spécifie pas d’audio.

fRemoteConsoleAudio

Spécifie s’il faut laisser la lecture audio sur l’ordinateur distant.

EncryptionLevel

Spécifie le niveau de chiffrement.

ColorDepth

Spécifie la profondeur de couleur du moniteur client. Pour connaître les valeurs possibles, consultez le membre ColorDepth de la structure WTS_CLIENT_DISPLAY .

ProtocolType

Spécifie le type de protocole.

HRes

Spécifie la résolution horizontale du moniteur client.

VRes

Spécifie la résolution verticale du moniteur client.

ClientProductId

ID de produit du logiciel client.

OutBufCountHost

Nombre de mémoires tampons de sortie sur l’hôte.

OutBufCountClient

Nombre de mémoires tampons de sortie sur le client.

OutBufLength

Longueur des mémoires tampons de sortie, en octets.

KeyboardLayout

Spécifie la disposition du clavier.

MaxConnectionTime

Durée maximale de la session des services Bureau à distance, en minutes.

MaxDisconnectionTime

Durée maximale, en minutes, pendant laquelle une session des services Bureau à distance déconnectée reste active sur le serveur hôte de session Bureau à distance.

MaxIdleTime

Durée maximale, en minutes, pendant laquelle la session des services Bureau à distance peut rester inactive.

PerformanceFlags

Spécifie un ensemble de fonctionnalités qui peuvent être définies sur le serveur pour améliorer les performances. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

WRDS_PERF_DISABLE_NOTHING (0x00000000)

Aucune fonctionnalité n’est désactivée.

WRDS_PERF_DISABLE_WALLPAPER (0x00000001)

Le papier peint sur le bureau n’est pas affiché.

WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)

Le glisser-fenêtre complète est désactivé ; seul le contour de la fenêtre s’affiche lorsque la fenêtre est déplacée.

WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)

Les animations de menu sont désactivées.

WRDS_PERF_DISABLE_THEMING (0x00000008)

Les thèmes sont désactivés.

WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)

Activez les graphiques améliorés.

WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)

Aucune ombre n’est affichée pour le curseur.

WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)

Le clignotement du curseur est désactivé.

WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)

Activez le lissage des polices.

WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)

Activez la composition du bureau.

KeyboardType

Spécifie le type de clavier.

KeyboardSubType

Spécifie le sous-type de clavier.

KeyboardFunctionKey

Spécifie la clé de fonction.

ActiveInputLocale

Spécifie l’identificateur de paramètres régionaux d’entrée. Le mot bas contient un identificateur de langue et le mot haut contient un handle d’appareil à la disposition physique du clavier.

SerialNumber

Numéro de série unique de l’ordinateur client.

ClientAddressFamily

Famille d’adresses IP du client.

ClientBuildNumber

Numéro de build du client.

ClientSessionId

ID de session client.

WorkDirectory[WTS_DIRECTORY_LENGTH + 1]

Chaîne qui contient le répertoire où réside le programme initial. Cette valeur est utilisée si fInheritInitialProgram a la valeur TRUE.

InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]

Valeur de chaîne qui spécifie le nom du programme initial. Cette valeur est utilisée si fInheritInitialProgram a la valeur TRUE.

UserName[WTS_USERNAME_LENGTH + 1]

Chaîne qui spécifie le nom d’utilisateur. Cette valeur est utilisée si fInheritAutoLogon a la valeur TRUE.

Domain[WTS_DOMAIN_LENGTH + 1]

Chaîne qui spécifie le domaine de l’utilisateur. Cette valeur est utilisée si fInheritAutoLogon a la valeur TRUE.

Password[WTS_PASSWORD_LENGTH + 1]

Chaîne qui spécifie le mot de passe de l’utilisateur. Cette valeur est utilisée si fInheritAutoLogon a la valeur TRUE.

ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]

Chaîne qui contient le nom du protocole.

DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]

Chaîne qui spécifie le nom du pilote d’affichage à charger.

DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]

Chaîne qui spécifie le nom de l’appareil d’affichage.

imeFileName[WTS_IMEFILENAME_LENGTH + 1]

Spécifie le nom de l’éditeur de méthode d’entrée.

AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]

Chaîne qui contient le nom du pilote audio à charger.

ClientName[WTS_CLIENTNAME_LENGTH + 1]

Chaîne qui contient le nom complet de l’ordinateur client.

ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]

Chaîne qui contient l’adresse IP du client au format décimal en pointillés.

ClientDirectory[WTS_DIRECTORY_LENGTH + 1]

Répertoire client.

Chaîne qui contient le répertoire client.

ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]

Chaîne qui contient un identificateur de produit client.

ClientSockAddress

Structure WRDS_SOCKADDR qui contient des informations d’adresse de socket.

ClientTimeZone

Une structure de WRDS_TIME_ZONE_INFORMATION qui contient des informations de fuseau horaire client.

WRdsListenerSettings

Structure WRDS_LISTENER_SETTINGS qui contient les paramètres de l’écouteur.

EventLogActivityId

ContextSize

Taille, en octets, du tableau ContextData .

ContextData

Tableau d’octets qui contient des données contextuelles pour la connexion. La taille de ce tableau est spécifiée dans le membre ContextSize .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012
En-tête	wtsdefs.h (include Wtsprotocol.h)