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) |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour