Partager via

Méthode IRemoteDesktopClientSettings ::SetRdpProperty (rdpappcontainerclient.h)

  • Article

Définit la valeur d’une propriété RDP nommée unique.

Syntaxe

HRESULT SetRdpProperty(
  [in] BSTR    propertyName,
  [in] VARIANT value
);

Paramètres

[in] propertyName

Chaîne qui spécifie le nom de la propriété.

Note Ces valeurs de chaîne ne respectent pas la casse.
 

Les valeurs possibles sont .

« session d’administration » (booléen)

Spécifie si la session est une session d’administration. Il peut s’agir de l’une des valeurs suivantes.

false

La session n’est pas une session d’administration.

True

La session est une session d’administration.

« autoriser le lissage de police » (booléen)

Spécifie si le lissage des polices est autorisé dans la session à distance. Il peut s’agir de l’une des valeurs suivantes.

false

Le lissage de police n’est pas autorisé.

True

Le lissage de police est autorisé.

« alternate full address » (String)

Spécifie un autre nom ou adresse IP de l’ordinateur distant auquel vous souhaitez vous connecter.

« audiocapturemode » (booléen)

Spécifie le mode de capture d’entrée audio. Il peut s’agir de l’une des valeurs suivantes.

false

Ne capturez pas d’entrée audio.

True

Capturez l’entrée audio.

« audiomode » (Nombre)

Spécifie l’emplacement de lecture des sons. Il peut s’agir de l’une des valeurs suivantes.

0

Lire des sons sur l’ordinateur client.

1

Lire les sons sur l’ordinateur hôte.

2

Ne pas lire de sons.

« niveau d’authentification » (nombre)

Spécifie le niveau d’authentification de la session distante. Il peut s’agir de l’une des valeurs suivantes.

0

Aucun.

1

Authentification requise.

2

Authentification négociable.

3

Authentification non spécifiée.

« connection type » (Number)

Spécifie le type de connexion Il peut s’agir de l’une des valeurs suivantes.

1

Modem

2

Haut débit bas débit

3

Satellite

4

Haut débit

5

WAN

6

LAN

7

Détection automatique

Spécifie l’adresse du serveur d’authentification basé sur les cookies.

« desktopheight » (Nombre)

Spécifie la hauteur, en pixels, du bureau virtuel.

« desktopwidth » (Number)

Spécifie la largeur, en pixels, du bureau virtuel.

« désactiver le glissement de fenêtre complète » (booléen)

Spécifie si l’affichage du contenu de la fenêtre lors du glissement est désactivé. Il peut s’agir de l’une des valeurs suivantes.

false

activé

True

Désactivé

« désactiver les animations de menu » (booléen)

Spécifie si l’affichage des animations de menu est désactivé. Il peut s’agir de l’une des valeurs suivantes.

false

activé

True

Désactivé

« disable themes » (Boolean)

Spécifie si les thèmes sont désactivés. Il peut s’agir de l’une des valeurs suivantes.

false

activé

True

Désactivé

« désactiver le papier peint » (booléen)

Spécifie si les fonds d’écran sont affichés. Il peut s’agir de l’une des valeurs suivantes.

false

Les papiers peints sont affichés.

True

Les fonds d’écran ne sont pas affichés.

« domain » (String)

Spécifie le domaine utilisé pour se connecter à la session distante.

« enablecredsspsupport » (Boolean)

Spécifie s’il faut utiliser l’authentification basée sur CredSSP pour la session distante. Il peut s’agir de l’une des valeurs suivantes.

false

N’utilisez pas l’authentification basée sur CredSSP.

True

Utilisez l’authentification basée sur CredSSP.

« full address » (String)

Spécifie l’adresse de l’ordinateur connecté.

« gatewaycredentialssource » (Nombre)

Spécifie la source des informations d’identification pour la passerelle Bureau à distance. Il peut s’agir de l’une des valeurs suivantes.

0

Invitez l’utilisateur à entrer ses informations d’identification et utilisez l’authentification NTLM.

1

Utilisez un carte intelligent pour les informations d’identification.

2

Utilisez les informations d’identification de l’utilisateur actuellement connecté.

3

Invitez l’utilisateur à entrer ses informations d’identification et utilisez l’authentification de base.

4

L’utilisateur sélectionnera la source d’informations d’identification lors de l’ouverture de session.

5

Utilisez l’authentification basée sur les cookies.

« gatewayhostname » (String)

Spécifie le nom du serveur de passerelle Bureau à distance.

« gatewayprofileusagemethod » (Nombre)

Spécifie l’utilisation du profil de passerelle Bureau à distance. Il peut s’agir de l’une des valeurs suivantes.

0

Utilisez les paramètres de profil de passerelle, le cas échéant.

1

Utilisez les paramètres de passerelle explicites, même si un profil de passerelle existe.

« gatewayusagemethod » (Nombre)

Spécifie l’utilisation de la passerelle Bureau à distance. Il peut s’agir de l’une des valeurs suivantes.

0

N’utilisez pas de serveur de passerelle Bureau à distance. La zone Contourner le serveur de passerelle Bureau à distance pour les adresses locales case activée est désactivée.

1

Utilisez la passerelle Bureau à distance spécifiée par la propriété « gatewayhostname ».

2

Détectez automatiquement les paramètres du serveur de passerelle Bureau à distance.

3

Utilisez les paramètres par défaut paramètres d’utilisation de la passerelle Bureau à distance.

4

N’utilisez pas de serveur de passerelle Bureau à distance. La zone Contourner le serveur de passerelle Bureau à distance pour les adresses locales case activée est sélectionnée.

« souris haute résolution » (booléen)

Spécifie le mode de résolution pour l’entrée de la souris. Il peut s’agir de l’une des valeurs suivantes.

false

L’entrée de la souris sera coalescée. Les données de la souris seront sous-échantillonnée et envoyées en fonction du taux d’échantillonnage par défaut.

True

L’entrée de la souris ne sera pas coalescée. Les données de la souris seront envoyées en pleine résolution.

« loadbalanceinfo » (String)

Contient le cookie d’équilibrage de charge utilisé pour choisir le meilleur serveur pour l’ordinateur client.

« adresse de page web de connexion » (Chaîne)

Spécifie l’adresse de la page web de connexion.

« adresse du serveur de pré-authentification » (chaîne)

Spécifie l’adresse du serveur de pré-authentification.

« invite pour les informations d’identification » (booléen)

Spécifie si l’utilisateur sera invité à entrer ses informations d’identification. Il peut s’agir de l’une des valeurs suivantes.

false

L’utilisateur ne sera pas invité à entrer les informations d’identification.

True

L’utilisateur sera invité à entrer des informations d’identification.

« promptcredentialonce » (Nombre)

Spécifie si le partage d’informations d’identification pour la passerelle Bureau à distance est activé. Il peut s’agir de l’une des valeurs suivantes.

0

Le partage d’informations d’identification est désactivé.

1

Le partage d’informations d’identification est activé.

« redirectclipboard » (booléen)

Spécifie si le Presse-papiers du client est redirigé vers la session distante. Il peut s’agir de l’une des valeurs suivantes.

false

Le Presse-papiers n’est pas redirigé.

True

Le Presse-papiers est redirigé.

« redirectprinters » (booléen)

Spécifie si les imprimantes du client sont redirigées vers la session distante. Il peut s’agir de l’une des valeurs suivantes.

false

Les imprimantes ne sont pas redirigées.

True

Les imprimantes sont redirigées.

« exiger une pré-authentification » (nombre)

Spécifie si la pré-authentification est requise. Il peut s’agir de l’une des valeurs suivantes.

0

La pré-authentification n’est pas requise.

1

Une pré-authentification est requise.

« url de support » (Chaîne)

Spécifie l’URL à partir de laquelle obtenir des informations de support.

Booléen

« utiliser le nom du serveur de redirection » (booléen)

Spécifie si un serveur de redirection est autorisé. Il peut s’agir de l’une des valeurs suivantes.

false

Un serveur de redirection n’est pas autorisé.

True

Un serveur de redirection est autorisé.

« username » (String)

Spécifie le nom d’utilisateur utilisé pour se connecter à la session distante.

« WinRTEncryptedPassword » (String)

Spécifie un mot de passe chiffré. Pour définir cette propriété, vous devez effectuer les actions suivantes.

  1. Convertissez le mot de passe en texte clair en binaire à l’aide de la méthode ConvertStringToBinary sur la classe CryptographicBuffer .
  2. Définissez la propriété WinRTPasswordEncoding à l’aide d’une valeur équivalente pour le paramètre d’encodage que vous avez passé à la méthode ConvertStringToBinary à l’étape 1.
  3. Appelez la méthode DataProtectionProvider(String) en passant « LOCAL=user » pour la chaîne d’entrée.
  4. Appelez la méthode ProtectAsync pour chiffrer la chaîne binaire qui contient le mot de passe.
  5. Convertissez l’objet CryptographicBuffer retourné par la méthode ProtectAsync en une valeur encodée en Base64 à l’aide de la méthode EncodeToBase64String .
  6. Définissez cette propriété (WinRTEncryptedPassword) avec la chaîne encodée en Base64 obtenue à l’étape 5.

« WinRTPasswordEncoding » (Nombre)

Spécifie le type d’encodage qui peut être appliqué à un mot de passe chiffré. Il peut s’agir de l’une des valeurs suivantes. La valeur par défaut est 1. Cette propriété doit être définie avant de définir la propriété WinRTEncryptedPassword .

0

UTF8

1

UTF16LE

2

UTF16BE

« Id d’espace de travail » (chaîne)

Spécifie l’identificateur de l’espace de travail RemoteApp and Desktop Connection dont ce fichier RDP a été publié dans le cadre.

[in] value

Nouvelle valeur de la propriété.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête rdpappcontainerclient.h
DLL MsTscAx.dll

Voir aussi

IRemoteDesktopClientSettings