Properti IMsTscNonScriptable::ClearTextPassword

Menyetel kata sandi kontrol ActiveX Desktop Jauh dalam format teks biasa.

Properti ini hanya untuk menulis.

Sintaks

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

Nilai properti

Kata sandi yang akan digunakan untuk menyambungkan, ditentukan dalam format teks biasa.

Kode kesalahan

Mengembalikan S_OK jika berhasil.

Keterangan

Kata sandi diteruskan ke server di saluran komunikasi RDP yang dienkripsi dengan aman. Setelah kata sandi teks biasa diatur, kata sandi tidak dapat diambil dalam format teks biasa.

Properti ClearTextPassword hanya dapat diatur ketika kontrol ActiveX Desktop Jauh tidak dalam status tersambung. Pengaturan properti ini gagal jika kontrol tersambung. Untuk memeriksa status tersambung, ambil properti IMsTscAx::Connected .

Anda juga dapat memanggil metode ini untuk mengatur kata sandi teks biasa sebelum mengonversinya ke kata sandi yang dikodekan portabel atau ke kata sandi yang dikodekan biner (tidak dapat dilaporkan). Namun perhatikan bahwa kata sandi yang dikodekan tidak boleh dianggap terenkripsi dengan aman.

Jika Pertama-tama Anda memanggil metode ini untuk mengatur kata sandi dalam format teks biasa, Anda kemudian dapat mengonversi kata sandi ke format yang dikodekan.

Untuk mengonversi kata sandi teks biasa ke format yang dikodekan

1. Atur kata sandi dalam format teks biasa di properti ClearTextPassword .
2. Untuk mengambil kata sandi dalam format yang dikodekan biner (tidak dapat didukung), ambil properti BinaryPassword dan properti BinarySalt . Baik bagian kata sandi yang dikodekan dan bagian salt diperlukan untuk mengatur kata sandi dalam format yang dikodekan biner.
3. Untuk mengambil kata sandi dalam format yang dikodekan portabel, ambil metode PortablePassword dan properti PortableSalt . Kedua bagian diperlukan untuk mengatur kata sandi dalam format yang dikodekan portabel.

Setelah mengikuti tiga langkah sebelumnya, Anda dapat mengatur kata sandi dalam format yang dikodekan dengan mengatur properti BinaryPassword dan BinarySalt , atau properti PortablePassword dan PortableSalt . Kedua bagian diperlukan.

Untuk mengaktifkan masuk otomatis, Anda juga harus mengatur properti UserName dan Domain . Jika kata sandi gagal mengautentikasi pengguna, kotak dialog Masuk Windows ditampilkan di server untuk meminta kata sandi kepada pengguna.

Untuk informasi selengkapnya tentang Sambungan Web Desktop Jauh, lihat Persyaratan untuk Koneksi Web Desktop Jarak Jauh.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Pustaka jenis	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsTscNonScriptable didefinisikan sebagai c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

Lihat juga

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable