Metode IRemoteDesktopClientSettings::SetRdpProperty (rdpappcontainerclient.h)
Mengatur nilai properti RDP bernama tunggal.
Sintaks
HRESULT SetRdpProperty(
[in] BSTR propertyName,
[in] VARIANT value
);
Parameter
[in] propertyName
String yang menentukan nama properti .
Nilai yang mungkin adalah.
"sesi administratif" (Boolean)
Menentukan apakah sesi tersebut merupakan sesi administratif. Ini bisa menjadi salah satu nilai berikut.
salah
Sesi ini bukan sesi administratif.
True
Sesi ini adalah sesi administratif.
"izinkan penghalusan font" (Boolean)
Menentukan apakah penghalusan font diperbolehkan dalam sesi jarak jauh. Ini bisa menjadi salah satu nilai berikut.
salah
Penghalusan font tidak diperbolehkan.
True
Penghalusan font diperbolehkan.
"alamat lengkap alternatif" (String)
Menentukan nama alternatif atau alamat IP komputer jarak jauh yang ingin Anda sambungkan.
"audiocapturemode" (Boolean)
Menentukan mode pengambilan input audio. Ini bisa menjadi salah satu nilai berikut.
salah
Jangan mengambil input audio.
True
Ambil input audio.
"audiomode" (Angka)
Menentukan di mana suara diputar. Ini bisa menjadi salah satu nilai berikut.
0
Putar suara pada komputer klien.
1
Putar suara pada komputer host.
2
Jangan bermain suara.
"tingkat autentikasi" (Angka)
Menentukan tingkat autentikasi sesi jarak jauh. Ini bisa menjadi salah satu nilai berikut.
0
Tidak ada.
1
Autentikasi diperlukan.
2
Autentikasi dapat dinegosiasikan.
3
Autentikasi tidak ditentukan.
"jenis koneksi" (Angka)
Menentukan tipe koneksi Ini bisa menjadi salah satu nilai berikut.
1
Modem
2
Broadband berkecepatan rendah
3
Satellite
4
Broadband berkecepatan tinggi
5
WAN
6
LAN
7
Deteksi otomatis
"alamat server autentikasi berbasis cookie" (String)
Menentukan alamat server autentikasi berbasis cookie.
"desktopheight" (Angka)
Menentukan tinggi, dalam piksel, dari desktop virtual.
"desktopwidth" (Angka)
Menentukan lebar, dalam piksel, dari desktop virtual.
"nonaktifkan seret jendela penuh" (Boolean)
Menentukan apakah menampilkan isi jendela saat menyeret dinonaktifkan. Ini bisa menjadi salah satu nilai berikut.
salah
Aktif
True
Nonaktif
"nonaktifkan menu anims" (Boolean)
Menentukan apakah menu animasi dinonaktifkan. Ini bisa menjadi salah satu nilai berikut.
salah
Aktif
True
Nonaktif
"nonaktifkan tema" (Boolean)
Menentukan apakah tema dinonaktifkan. Ini bisa menjadi salah satu nilai berikut.
salah
Aktif
True
Nonaktif
"nonaktifkan wallpaper" (Boolean)
Menentukan apakah wallpaper ditampilkan. Ini bisa menjadi salah satu nilai berikut.
salah
Wallpaper ditampilkan.
True
Wallpaper tidak ditampilkan.
"domain" (String)
Menentukan domain yang digunakan untuk menyambungkan ke sesi jarak jauh.
"enablecredsspsupport" (Boolean)
Menentukan apakah akan menggunakan autentikasi berbasis CredSSP untuk sesi jarak jauh. Ini bisa menjadi salah satu nilai berikut.
salah
Jangan gunakan autentikasi berbasis CredSSP.
True
Gunakan autentikasi berbasis CredSSP.
"alamat lengkap" (String)
Menentukan alamat komputer yang tersambung.
"gatewaycredentialssource" (Angka)
Menentukan sumber untuk kredensial untuk gateway Desktop Jauh. Ini bisa menjadi salah satu nilai berikut.
0
Minta kredensial pengguna dan gunakan autentikasi NTLM.
1
Gunakan kartu pintar untuk kredensial.
2
Gunakan kredensial untuk pengguna yang saat ini masuk.
3
Minta kredensial pengguna dan gunakan autentikasi dasar.
4
Pengguna akan memilih sumber kredensial saat masuk.
5
Gunakan autentikasi berbasis cookie.
"gatewayhostname" (String)
Menentukan nama server gateway Desktop Jauh.
"gatewayprofileusagemethod" (Angka)
Menentukan penggunaan profil gateway Desktop Jauh. Ini bisa menjadi salah satu nilai berikut.
0
Gunakan pengaturan profil gateway, jika ada.
1
Gunakan pengaturan gateway eksplisit, meskipun ada profil gateway.
"gatewayusagemethod" (Angka)
Menentukan penggunaan gateway Desktop Jauh. Ini bisa menjadi salah satu nilai berikut.
0
Jangan gunakan server gateway Desktop Jauh. Kotak centang Lewati server Gateway RD untuk alamat lokal dikosongkan .
1
Gunakan gateway Desktop Jauh yang ditentukan oleh properti "gatewayhostname".
2
Mendeteksi pengaturan server gateway Desktop Jauh secara otomatis.
3
Gunakan pengaturan default pengaturan penggunaan gateway Desktop Jauh.
4
Jangan gunakan server gateway Desktop Jauh. Kotak centang Lewati server Gateway RD untuk alamat lokal dipilih.
"mouse resolusi tinggi" (Boolean)
Menentukan mode resolusi untuk input mouse. Ini bisa menjadi salah satu nilai berikut.
salah
Input mouse akan digabungkan. Data mouse akan disubsampel dan dikirim sesuai dengan laju pengambilan sampel default.
True
Input tetikus tidak akan digabungkan. Data mouse akan dikirim dengan resolusi penuh.
"loadbalanceinfo" (String)
Berisi cookie penyeimbangan beban yang digunakan untuk memilih server terbaik untuk komputer klien.
"alamat halaman web login" (String)
Menentukan alamat halaman web masuk.
"alamat server pra-autentikasi" (String)
Menentukan alamat server praauthentikasi.
"prompt for credentials" (Boolean)
Menentukan apakah pengguna akan dimintai kredensial mereka. Ini bisa menjadi salah satu nilai berikut.
salah
Pengguna tidak akan dimintai kredensial.
True
Pengguna akan dimintai kredensial.
"promptcredentialonce" (Angka)
Menentukan apakah berbagi kredensial untuk gateway Desktop Jauh diaktifkan. Ini bisa menjadi salah satu nilai berikut.
0
Berbagi kredensial dinonaktifkan.
1
Berbagi kredensial diaktifkan.
"redirectclipboard" (Boolean)
Menentukan apakah clipboard untuk klien dialihkan ke sesi jarak jauh. Ini bisa menjadi salah satu nilai berikut.
salah
Papan klip tidak dialihkan.
True
Clipboard dialihkan.
"redirectprinters" (Boolean)
Menentukan apakah pencetak untuk klien diarahkan ke sesi jarak jauh. Ini bisa menjadi salah satu nilai berikut.
salah
Pencetak tidak dialihkan.
True
Pencetak dialihkan.
"memerlukan pra-autentikasi" (Angka)
Menentukan apakah praauthentikasi diperlukan. Ini bisa menjadi salah satu nilai berikut.
0
Pra-autentikasi tidak diperlukan.
1
Pra-autentikasi diperlukan.
"url dukungan" (String)
Menentukan URL untuk mendapatkan informasi dukungan.
Boolean
"gunakan nama server pengalihan" (Boolean)
Menentukan apakah server pengalihan diizinkan. Ini bisa menjadi salah satu nilai berikut.
salah
Server pengalihan tidak diperbolehkan.
True
Server pengalihan diperbolehkan.
"nama pengguna" (String)
Menentukan nama pengguna yang digunakan untuk menyambungkan ke sesi jarak jauh.
"WinRTEncryptedPassword" (String)
Menentukan kata sandi terenkripsi. Untuk mengatur properti ini, Anda harus melakukan tindakan berikut.
- Konversikan kata sandi teks yang jelas menjadi biner dengan menggunakan metode ConvertStringToBinary pada kelas CryptographicBuffer .
- Atur properti WinRTPasswordEncoding dengan menggunakan nilai yang setara untuk parameter pengodean yang Anda berikan ke metode ConvertStringToBinary di langkah 1.
- Panggil metode DataProtectionProvider(String) dengan meneruskan "LOCAL=user" untuk string input.
- Panggil metode ProtectAsync untuk mengenkripsi string biner yang berisi kata sandi.
- Konversikan objek CryptographicBuffer yang dikembalikan oleh metode ProtectAsync menjadi nilai yang dikodekan Base64 dengan menggunakan metode EncodeToBase64String .
- Atur properti ini (WinRTEncryptedPassword) dengan string yang dikodekan Base64 yang diperoleh di langkah 5.
"WinRTPasswordEncoding" (Angka)
Menentukan jenis pengodean yang dapat diterapkan ke kata sandi terenkripsi. Ini bisa menjadi salah satu nilai berikut. Nilai default adalah 1. Properti ini harus diatur sebelum mengatur properti WinRTEncryptedPassword .
0
UTF8
1
UTF16LE
2
UTF16BE
"Id Ruang Kerja" (String)
Menentukan pengidentifikasi ruang kerja RemoteApp dan Koneksi Desktop tempat file RDP ini diterbitkan sebagai bagian dari.
[in] value
Nilai properti baru.
Nilai kembali
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 |
| Server minimum yang didukung | Windows Server 2012 |
| Target Platform | Windows |
| Header | rdpappcontainerclient.h |
| DLL | MsTscAx.dll |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk