Fungsi WTSVirtualChannelOpenEx (wtsapi32.h)
Membuat saluran virtual dengan cara yang mirip dengan WTSVirtualChannelOpen.
API ini mendukung pembuatan saluran virtual statis (SVC) dan saluran virtual dinamis (DVC). Jika parameter bendera adalah nol, parameter berperilaku sama dengan WTSVirtualChannelOpen. DVC dapat dibuka dengan menentukan bendera yang sesuai. Setelah DVC dibuat, Anda bisa menggunakan fungsi yang sama untuk Baca, Tulis, Kueri, atau Tutup yang digunakan untuk SVC.
Sintaks
HANDLE WTSVirtualChannelOpenEx(
[in] DWORD SessionId,
[in] LPSTR pVirtualName,
[in] DWORD flags
);
Parameter
[in] SessionId
Pengidentifikasi sesi Layanan Desktop Jarak Jauh. Untuk menunjukkan sesi saat ini, tentukan WTS_CURRENT_SESSION. Anda dapat menggunakan fungsi WTSEnumerateSessions untuk mengambil pengidentifikasi semua sesi di server Host Sesi RD tertentu.
Agar dapat membuka saluran virtual pada sesi pengguna lain, Anda harus memiliki izin Saluran Virtual. Untuk informasi selengkapnya, lihat Izin Layanan Desktop Jarak Jauh. Untuk mengubah izin pada sesi, gunakan alat administratif Konfigurasi Layanan Desktop Jarak Jauh.
[in] pVirtualName
Dalam kasus SVC, menunjuk ke string yang dihentikan null yang berisi nama saluran virtual. Panjang nama SVC terbatas pada CHANNEL_NAME_LEN karakter, tidak termasuk null yang mengakhiri.
Dalam kasus DVC, arahkan ke string yang dihentikan null yang berisi nama titik akhir pendengar. Panjang nama DVC terbatas pada MAX_PATH karakter.
[in] flags
Untuk membuka saluran sebagai SVC, tentukan nol untuk parameter ini. Untuk membuka saluran sebagai DVC, tentukan WTS_CHANNEL_OPTION_DYNAMIC.
Saat membuka DVC, Anda dapat menentukan pengaturan prioritas untuk data yang sedang ditransfer dengan menentukan salah satu nilai WTS_CHANNEL_OPTION_DYNAMIC_PRI_XXXX yang dikombinasikan dengan nilai WTS_CHANNEL_OPTION_DYNAMIC .
WTS_CHANNEL_OPTION_DYNAMIC_NO_COMPRESS
Menonaktifkan pemadatan untuk DVC ini. Anda harus menentukan nilai ini dalam kombinasi dengan nilai WTS_CHANNEL_OPTION_DYNAMIC .
WTS_CHANNEL_OPTION_DYNAMIC_PRI_LOW (default)
Prioritas rendah. Data akan dikirim di kedua sisi dengan prioritas rendah. Gunakan tingkat prioritas ini untuk transfer blok dari semua ukuran, di mana kecepatan transfer tidak penting. Dalam hampir semua kasus (95%), saluran harus dibuka dengan bendera ini.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_MED
Prioritas sedang. Gunakan tingkat prioritas ini untuk mengirim pesan kontrol singkat yang harus memiliki prioritas atas data di saluran berprioritas rendah.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_HIGH
Prioritas tinggi. Gunakan tingkat prioritas ini untuk data yang penting dan secara langsung memengaruhi pengalaman pengguna. Ukuran transfer dapat bervariasi. Data tampilan termasuk dalam kategori ini.
WTS_CHANNEL_OPTION_DYNAMIC_PRI_REAL
Prioritas real time. Gunakan tingkat prioritas ini hanya dalam kasus di mana transfer data benar-benar penting. Ukuran transfer data harus dibatasi hingga beberapa ratus byte per pesan.
Mengembalikan nilai
NULL pada kesalahan dengan set GetLastError .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | wtsapi32.h |
Pustaka | Wtsapi32.lib |
DLL | Wtsapi32.dll |
Set API | ext-ms-win-session-wtsapi32-l1-1-0 (diperkenalkan dalam Windows 8) |