Metode IRDPSRAPISessionProperties::p ut_Property (rdpencomapi.h)

Artikel
08/25/2023

Mengatur atau mendapatkan properti sesi bernama.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Parameter

PropertyName

newVal

Nilai kembali

Tidak ada

Keterangan

Anda bisa mengatur dan mendapatkan properti berikut. Nama properti peka huruf besar/kecil.

Nama properti	Deskripsi properti	Jenis nilai
"DrvConAttach"	Catatan Properti DrvConAttach tidak lagi tersedia untuk digunakan pada Windows 10. Tidak ada lagi driver cermin untuk berbagi. Ada dua mode untuk lampiran driver cermin. Yang pertama adalah mode beban dinamis. Dalam mode ini, driver cermin akan segera dilampirkan setelah peserta terhubung ke sesi dan memiliki kontrol tampilan. Driver cermin akan secara otomatis dilepas ketika peserta terakhir meninggalkan sesi (atau tidak ada peserta dengan kontrol tampilan). Mode kedua adalah mode beban statis. Dalam mode ini, driver cermin dimuat segera setelah sesi dibuka dan tidak dibongkar sampai sesi berakhir. Perhatikan bahwa dalam kedua mode driver mungkin dilepas dan dilampirkan kembali sebagai akibat dari peristiwa eksternal seperti mengubah resolusi layar atau berbagi kedalaman warna. Atur properti ini ke VARIANT_TRUE untuk mode lampiran dinamis dan ke VARIANT_FALSE untuk mode lampiran statis. Perhatikan bahwa Anda dapat mengatur properti ini hanya sebelum memanggil metode IRDPSRAPISharingSession::Open ; properti ini menjadi baca-saja setelah metode Buka dipanggil. Defaultnya adalah VARIANT_TRUE. Untuk skenario 1:1 seperti Bantuan Jarak Jauh, Anda harus menggunakan mode beban dinamis karena dapat memakan waktu yang sangat lama antara saat sesi dibuka dan saat pakar akan terhubung. Untuk skenario 1:M (multipihak), Anda harus menggunakan mode beban statis karena melampirkan dan melepaskan driver cermin cukup mengganggu dan tidak boleh dilakukan kecuali ada alasan yang baik.	VT_BOOL
"PortId"	Port pendengar untuk koneksi masuk dari sharer. Properti ini juga dapat diatur di sisi penampil tetapi hanya akan digunakan untuk mendengarkan koneksi jika terjadi koneksi terbalik.	VT_I4
"PortProtocol"	Menentukan keluarga protokol untuk memulai pendengar di sharer. Nilai yang mungkin adalah sebagai berikut: AF_UNSPEC Nilai: 0 Keluarga alamat tidak ditentukan. AF_INET Nilai: 2 Keluarga alamat Protokol Internet versi 4 (IPv4). AF_INET6 Nilai: 23 Keluarga alamat Protokol Internet versi 6 (IPv6).	VT_I4
"SetNetworkStream"	Penunjuk ke antarmuka IUnknown yang mendukung antarmuka IRDPSRAPITransportStream . Jika properti ini diatur, metode Sambungkan akan menggunakan aliran ini dan mengabaikan string koneksi yang dilewati. Properti ini hanya berlaku untuk sisi penampil.	VT_UNKNOWN
"EnforceStrongEncryption"	Jika properti ini memiliki nilai VARIANT_TRUE, pembagian mengharuskan penampil untuk menggunakan enkripsi yang mematuhi Standar Pemrosesan Informasi Federal (FIPS) 140. Defaultnya adalah VARIANT_FALSE. Properti ini menjadi baca-saja setelah metode IRDPSRAPISharingSession::Open dipanggil. Anda hanya dapat mengatur properti ini sebelum memanggil metode tersebut. Dukungan penampil untuk kepatuhan FIPS 140 ditambahkan di Windows 10, versi 1709. Sharer menolak koneksi dari versi penampil sebelumnya ke Windows 10, versi 1709. Properti ini hanya berlaku untuk sisi sharer.	VT_BOOL
"FrameCaptureIntervalInMs"	Menentukan interval pengambilan bingkai. Secara default, interval pengambilan bingkai adalah 33 milidetik, yang sesuai dengan 30 bingkai per detik. Anda dapat menggunakan properti ini untuk mengoptimalkan performa. Jika pembaruan layar tidak perlu sering dilakukan, interval pengambilan dapat ditingkatkan. Misalnya, nilai 400 milidetik menghasilkan 2,5 bingkai per detik. Properti ini hanya berlaku untuk sisi sharer.	VT_I4
"DefaultAttendeeControlLevel"	Menentukan tingkat kontrol default untuk peserta. Secara default, nilai ini CTRL_LEVEL_NONE (tidak ada). Anda dapat mengubah nilai ini menjadi CTRL_LEVEL_VIEW (tampilan). Tingkat kontrol default tidak dapat diatur ke interaktif. Properti ini hanya berlaku untuk sisi sharer.	VT_I4
"EnableClipboardRedirect"	Jika properti ini memiliki nilai VARIANT_TRUE, clipboard antara sharer dan viewer diaktifkan. Defaultnya adalah VARIANT_FALSE. Untuk menggunakan berbagi papan klip, sesi harus dalam mode interaktif. Hanya satu koneksi yang dapat berbagi clipboard. Koneksi yang baru-baru ini diperoleh kontrol input mengambil alih berbagi clipboard. Berbagi papan klip untuk koneksi sebelumnya secara otomatis dinonaktifkan. Properti ini hanya dapat digunakan untuk aplikasi desktop. Properti ini hanya berlaku untuk sisi sharer. Properti ini tersedia dimulai dengan Windows 10, versi 1511.	VT_BOOL
"SetClipboardRedirectCallback"	Menentukan penunjuk IUnknown ke instans IRDPSRAPIClipboardUseEvents yang menerima panggilan balik setiap kali penyalinan dari komputer sharer ke penampil dicoba. Properti ini hanya relevan jika berbagi papan klip diaktifkan. Properti ini menjadi baca-saja setelah metode IRDPSRAPISharingSession::Open dipanggil. Anda hanya dapat mengatur properti ini sebelum memanggil metode tersebut. Properti ini hanya dapat digunakan untuk aplikasi desktop. Properti ini hanya berlaku untuk sisi sharer. Properti ini tersedia dimulai dengan Windows 10, versi 1511.	VT_UNKNOWN
"EnabledTransports"	Menentukan transportasi yang akan diaktifkan. Nilai 3 mendukung TCP dan UDP. Defaultnya adalah 1, yang hanya TCP. Properti ini menjadi baca-saja setelah metode IRDPSRAPISharingSession::Open dipanggil. Anda hanya dapat mengatur properti ini sebelum memanggil metode tersebut. Properti ini tersedia dimulai dengan Windows 10, versi 1803. Properti ini hanya berlaku untuk sisi sharer.	VT_I4

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rdpencomapi.h
DLL	RdpEncom.dll

Lihat juga

IRDPSRAPISessionProperties

Bagikan melalui