Fungsi WTSVirtualChannelOpen (wtsapi32.h)

  • Artikel

Membuka handel ke akhir server dari saluran virtual tertentu.

Fungsi ini usang. Sebagai gantinya, gunakan fungsi WTSVirtualChannelOpenEx .

Sintaks

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

Parameter

[in] hServer

Parameter ini harus WTS_CURRENT_SERVER_HANDLE.

[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.

Untuk membuka saluran virtual pada sesi pengguna lain, Anda harus memiliki izin dari 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

Penunjuk ke string yang dihentikan null yang berisi nama saluran virtual. Perhatikan bahwa ini adalah string ANSI bahkan ketika UNICODE ditentukan. Nama saluran virtual terdiri dari satu hingga CHANNEL_NAME_LEN karakter, tidak termasuk null yang mengakhiri.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke saluran virtual yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Setelah Anda selesai menggunakan handel, lepaskan dengan memanggil fungsi WTSVirtualChannelClose .

Misalnya yang menunjukkan cara mendapatkan akses ke handel file saluran virtual yang dapat digunakan untuk I/O asinkron, lihat WTSVirtualChannelQuery.

Jika Anda mencoba menggunakan fungsi ini untuk membuka saluran virtual yang sama beberapa kali, itu dapat menyebabkan penundaan 10 detik dan mengganggu saluran yang dibuat.

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

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose