Interface IMsRdpClientAdvancedSettings

Article
06/13/2023

Gère les paramètres client avancés. Dérive de l’interface IMsTscAdvancedSettings . Cette interface inclut des méthodes permettant de récupérer et de définir des propriétés avancées (facultatives) pour le contrôle ActiveX Bureau à distance.

Pour obtenir une instance de cette interface, utilisez la propriété IMsTscAx::AdvancedSettings pour obtenir un pointeur d’interface IMsTscAdvancedSettings. Ensuite, appelez QueryInterface sur le pointeur IMsTscAdvancedSettings et passez IID_IMsRdpClientAdvancedSettings à QueryInterface.

Membres

L’interface IMsRdpClientAdvancedSettings hérite d’IMsTscAdvancedSettings. IMsRdpClientAdvancedSettings possède également les types de membres suivants :

Propriétés

Propriétés

L’interface IMsRdpClientAdvancedSettings possède ces propriétés.

Propriété	Type d’accès	Description
AcceleratorPassthrough	Lecture/écriture	Spécifie si les accélérateurs de clavier doivent être passés au serveur.
BitmapCacheSize	Lecture/écriture	Taille, en kilo-octets, du fichier de cache bitmap utilisé pour les bitmaps de 8 bits par pixel. Les valeurs numériques valides de cette propriété sont comprises entre 1 et 32 inclus.
BitmapPersistence	Lecture/écriture	Spécifie si la mise en cache bitmap persistante doit être utilisée. La mise en cache permanente peut améliorer les performances, mais nécessite un espace disque supplémentaire.
BitmapVirtualCache16BppSize	Lecture/écriture	Spécifie la taille, en mégaoctets, du fichier de cache bitmap persistant à utiliser pour les paramètres haute couleur de 15 et 16 bits par pixel.
BitmapVirtualCache24BppSize	Lecture/écriture	Spécifie la taille, en mégaoctets, du fichier de cache bitmap persistant à utiliser pour le paramètre couleur haute de 24 bits par pixel.
BitmapVirtualCacheSize	Lecture/écriture	Spécifie la taille, en mégaoctets, du fichier de cache bitmap persistant à utiliser pour la couleur 8 bits par pixel. Les valeurs numériques valides de cette propriété sont comprises entre 1 et 32 inclus. Notez que la taille maximale de tous les fichiers de cache virtuel est de 128 Mo. Les propriétés associées incluent les propriétés BitmapVirtualCache16BppSize et BitmapVirtualCache24BppSize .
brushSupportLevel	Lecture/écriture	Cette propriété n'est pas prise en charge.
CachePersistenceActive	Lecture/écriture	Spécifie si la mise en cache d’une bitmap persistante doit être utilisée.
ClearTextPassword	Écriture seule	Spécifie le mot de passe avec lequel se connecter. Pour plus d’informations, consultez l’interface IMsTscNonScriptable .
ConnectToServerConsole	Lecture/écriture	Cette propriété n'est pas prise en charge.
ConnectWithEndpoint	Écriture seule	Cette propriété n'est pas prise en charge.
DedicatedTerminal	Lecture/écriture	Cette propriété n'est pas prise en charge.
DisableCtrlAltDel	Lecture/écriture	Spécifie si l’écran explicatif initial dans Winlogon doit s’afficher.
DisplayConnectionBar	Lecture/écriture	Spécifie s’il faut utiliser la barre de connexion. La valeur par défaut est VARIANT_TRUE, ce qui active la propriété.
DoubleClickDetect	Lecture/écriture	Spécifie si le client identifie les double-clics pour le serveur.
EnableMouse	Lecture/écriture	Cette propriété n'est pas prise en charge.
EnableWindowsKey	Lecture/écriture	Spécifie si la clé Windows peut être utilisée dans la session distante.
EncryptionEnabled	Lecture/écriture	Cette propriété n'est pas prise en charge. Impossible de désactiver le chiffrement.
GrabFocusOnConnect	Lecture/écriture	Spécifie si le contrôle client doit avoir le focus lors de la connexion.
HotKeyAltEsc	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à ALT pour déterminer le raccourci clavier de remplacement pour ALT+ÉCHAP. VK_INSERT est la valeur par défaut, avec ALT+INSERT comme séquence résultante. Cette propriété est valide uniquement lorsque la propriété KeyboardHookMode n’est pas activée.
HotKeyAltShiftTab	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à ALT pour déterminer le raccourci clavier de remplacement pour ALT+MAJ+TAB. VK_NEXT est la valeur par défaut, avec ALT+PAGE DOWN comme séquence résultante. Cette propriété est valide uniquement lorsque la propriété KeyboardHookMode n’est pas activée.
HotKeyAltSpace	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à ALT pour déterminer le raccourci clavier de remplacement pour ALT+SPACE. VK_DELETE est la valeur par défaut, avec ALT+DELETE comme séquence résultante. Cette propriété est valide uniquement lorsque la propriété KeyboardHookMode n’est pas activée.
HotKeyAltTab	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à ALT pour déterminer le raccourci clavier de remplacement pour ALT+TAB. VK_PRIOR est la valeur par défaut, avec ALT+PAGE UP comme séquence résultante. Cette propriété est valide uniquement lorsque la propriété KeyboardHookMode n’est pas activée.
HotKeyCtrlAltDel	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à CTRL+ALT pour déterminer le raccourci clavier de remplacement pour CTRL+ALT+SUPPR, également appelé séquence d’attention sécurisée (SAS). VK_END est la valeur par défaut. Notez que même lorsque la propriété KeyboardHookMode est activée, CTRL+ALT+SUPPR n’est jamais redirigée vers le serveur distant ; CTRL+ALT+SUPPR est la séquence SAS locale.
HotKeyCtrlEsc	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à ALT pour déterminer le raccourci clavier de remplacement pour CTRL+ÉCHAP. VK_HOME est la valeur par défaut, avec ALT+HOME comme séquence résultante. Cette propriété est valide uniquement lorsque la propriété KeyboardHookMode n’est pas activée.
HotKeyFullScreen	Lecture/écriture	Spécifie le code de clé virtuelle à ajouter à CTRL+ALT pour déterminer le raccourci clavier de remplacement pour le passage en mode plein écran. VK_CANCEL est la valeur par défaut.
InputEventsAtOnce	Lecture/écriture	Cette propriété n'est pas prise en charge.
keepAliveInterval	Lecture/écriture	Spécifie un intervalle, en millisecondes, auquel le client envoie des messages keep-alive au serveur. La valeur par défaut de la propriété est zéro, ce qui désactive les messages keep-alive. La valeur minimale valide de cette propriété est 10 000, ce qui représente 10 secondes. Notez qu’un paramètre de stratégie de groupe qui spécifie si les connexions clientes persistantes au serveur sont autorisées peut remplacer ce paramètre de propriété.
KeyboardFunctionKey	Lecture/écriture	Valide pour Windows CE uniquement.
KeyboardSubType	Lecture/écriture	Valide pour Windows CE uniquement.
KeyboardType	Lecture/écriture	Valide pour Windows CE uniquement.
LoadBalanceInfo	Lecture/écriture	Spécifie le cookie d’équilibrage de charge qui sera placé dans le paquet demande de connexion X.224 dans la séquence de connexion du serveur hôte de session Bureau à distance.
maxEventCount	Lecture/écriture	Cette propriété n'est pas prise en charge.
MaximizeShell	Lecture/écriture	Spécifie si les programmes lancés avec la propriété StartProgram doivent être agrandis.
minInputSendInterval	Lecture/écriture	Spécifie l’intervalle minimal, en millisecondes, entre l’envoi d’événements de souris.
MinutesToIdleTimeout	Lecture/écriture	Spécifie la durée maximale, en minutes, pendant laquelle le client doit rester connecté sans entrée utilisateur. Si le temps spécifié s’écoule, le contrôle appelle la méthode IMsTscAxEvents::OnIdleTimeoutNotification .
NotifyTSPublicKey	Lecture/écriture	Cette propriété n'est pas prise en charge.
NumBitmapCaches	Lecture/écriture	Cette propriété n'est pas prise en charge.
orderDrawThreshold	Lecture/écriture	Cette propriété n'est pas prise en charge.
overallConnectionTimeout	Lecture/écriture	Spécifie la durée totale, en secondes, pendant laquelle le contrôle client attend qu’une connexion se termine. La valeur valide maximale de cette propriété est 600, ce qui représente 10 minutes. Si le temps spécifié s’écoule avant la fin de la connexion, le contrôle se déconnecte et appelle la méthode IMsTscAxEvents::OnDisconnected . Une propriété associée est singleConnectionTimeout.
PerformanceFlags	Lecture/écriture	Spécifie un ensemble de fonctionnalités qui peuvent être définies sur le serveur pour améliorer les performances.
PersistCacheDirectory	Écriture seule	Cette propriété n'est pas prise en charge.
PinConnectionBar	Lecture/écriture	Spécifie l’état de la barre de connexion de l’interface utilisateur. La définition de cette propriété sur VARIANT_TRUE définit l’état sur « abaissé », c’est-à-dire invisible pour l’utilisateur et indisponible pour l’entrée. VARIANT_FALSE définit l’état sur « élevé » et disponible pour l’entrée utilisateur.
RdpdrClipCleanTempDirString	Lecture/écriture	Cette propriété n'est pas prise en charge.
RdpdrClipPasteInfoString	Lecture/écriture	Cette propriété n'est pas prise en charge.
RdpdrLocalPrintingDocName	Lecture/écriture	Cette propriété n'est pas prise en charge.
RDPPort	Lecture/écriture	Spécifie le port de connexion. La valeur par défaut est 3389.
RedirectDrives	Lecture/écriture	Spécifie si la redirection des lecteurs de disque est autorisée.
RedirectPorts	Lecture/écriture	Spécifie si la redirection des ports locaux (par exemple, COM et LPT) est autorisée.
RedirectPrinters	Lecture/écriture	Spécifie si la redirection des imprimantes est autorisée.
RedirectSmartCards	Lecture/écriture	Spécifie si la redirection des cartes à puce est autorisée.
SasSequence	Lecture/écriture	Spécifie la séquence d’accès sécurisée que le client utilisera pour accéder à l’écran de connexion sur le serveur.
ScaleBitmapCachesByBPP	Lecture/écriture	Cette propriété n'est pas prise en charge.
ShadowBitmap	Lecture/écriture	Cette propriété n'est pas prise en charge. Windows Vista : Spécifie si les bitmaps d’ombre doivent être utilisées.
shutdownTimeout	Lecture/écriture	Spécifie la durée, en secondes, d’attente que le serveur réponde à une demande de déconnexion. La valeur par défaut de la propriété est 10. La valeur maximale valide de la propriété est 600, ce qui représente 10 minutes. Si le serveur ne répond pas dans le délai spécifié, le contrôle client se déconnecte.
singleConnectionTimeout	Lecture/écriture	Spécifie la durée maximale, en secondes, pendant laquelle le contrôle client attend une connexion à une adresse IP. Pendant la connexion, le contrôle peut tenter de se connecter à plusieurs adresses IP. La valeur maximale valide de cette propriété est 600. Une propriété associée est overallConnectionTimeout.
SmartSizing	Lecture/écriture	Spécifie si l’affichage doit être mis à l’échelle pour s’adapter à la zone cliente du contrôle. VARIANT_TRUE active la mise à l’échelle. Notez que les barres de défilement n’apparaissent pas lorsque la propriété SmartSizing est activée.
SmoothScroll	Lecture/écriture	Cette propriété n'est pas prise en charge.
TransportType	Lecture/écriture	Spécifie le type de transport utilisé par le client. Cette propriété n’est pas utilisée par le contrôle ActiveX Bureau à distance.
WinCEFixedPalette	Lecture/écriture	Valide pour Windows CE uniquement.

Notes

Cette interface a été étendue par les interfaces suivantes, chaque nouvelle interface héritant de toutes les méthodes et propriétés des interfaces précédentes :

Cette propriété ne peut pas être définie lorsque le contrôle est connecté, sauf indication contraire.

Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClientAdvancedSettings est défini comme 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2

Voir aussi

Informations de référence sur la connexion Web Bureau à distance
IMsTscAdvancedSettings