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)

Lihat juga

API Server DVC

Referensi Saluran Virtual Dinamis

WTSVirtualChannelBuka