Propriété IMsTscNonScriptable::ClearTextPassword

Définit le mot de passe de contrôle ActiveX du Bureau à distance au format en texte clair.

Cette propriété est en écriture seule.

Syntaxe

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

Valeur de la propriété

Mot de passe à utiliser pour la connexion, spécifié au format texte en clair.

Codes d’erreur

Retournez S_OK en cas de réussite.

Notes

Le mot de passe est transmis au serveur dans le canal de communication RDP chiffré en toute sécurité. Une fois qu’un mot de passe en texte clair est défini, il ne peut pas être récupéré au format texte brut.

La propriété ClearTextPassword ne peut être définie que lorsque le contrôle ActiveX Bureau à distance n’est pas dans l’état connecté. La définition de cette propriété échoue si le contrôle est connecté. Pour case activée pour l’état connecté, récupérez la propriété IMsTscAx::Connected.

Vous pouvez également appeler cette méthode pour définir un mot de passe en texte clair avant de le convertir en mot de passe codé portable ou en mot de passe codé binaire (non portable). Notez toutefois que les mots de passe encodés ne doivent pas être considérés comme chiffrés de manière sécurisée.

Si vous appelez d’abord cette méthode pour définir un mot de passe au format texte en clair, vous pouvez convertir le mot de passe au format encodé.

Pour convertir un mot de passe en texte clair au format codé

1. Définissez le mot de passe au format texte clair dans la propriété ClearTextPassword .
2. Pour récupérer le mot de passe au format binaire (nonportable) encodé, récupérez la propriété BinaryPassword et les propriétés BinarySalt . La partie de mot de passe encodée et la partie salt sont requises pour définir un mot de passe au format codé binaire.
3. Pour récupérer le mot de passe au format codé portable, récupérez la méthode PortablePassword et les propriétés PortableSalt . Les deux parties sont requises pour définir un mot de passe au format codé portable.

Après avoir suivi les trois étapes précédentes, vous pouvez définir le mot de passe au format encodé en définissant les propriétés BinaryPassword et BinarySalt , ou les propriétés PortablePassword et PortableSalt . Les deux parties sont obligatoires.

Pour activer l’ouverture de session automatique, vous devez également définir les propriétés UserName et Domain . Si le mot de passe ne parvient pas à authentifier l’utilisateur, la boîte de dialogue Ouverture de session Windows s’affiche sur le serveur pour inviter l’utilisateur à entrer le mot de passe.

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_IMsTscNonScriptable est défini comme c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

Voir aussi

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable