Fungsi panggilan balik VIRTUALCHANNELWRITE (cchannel.h)
Mengirim data dari akhir klien saluran virtual ke aplikasi mitra di ujung server.
Layanan Desktop Jauh menyediakan penunjuk ke fungsi VirtualChannelWrite dalam struktur CHANNEL_ENTRY_POINTS yang diteruskan ke titik masuk VirtualChannelEntry Anda.
Sintaks
VIRTUALCHANNELWRITE Virtualchannelwrite;
UINT VCAPITYPE Virtualchannelwrite(
[in] DWORD openHandle,
[in] LPVOID pData,
[in] ULONG dataLength,
[in] LPVOID pUserData
)
{...}
Parameter
[in] openHandle
Tangani ke saluran virtual. Ini adalah handel yang dikembalikan dalam parameter pOpenHandle dari fungsi VirtualChannelOpen .
[in] pData
Penunjuk ke buffer yang berisi data untuk ditulis.
[in] dataLength
Menentukan jumlah byte data dalam buffer pData untuk ditulis.
[in] pUserData
Nilai yang ditentukan aplikasi. Nilai ini diteruskan ke fungsi VirtualChannelOpenEvent Anda ketika operasi tulis selesai atau dibatalkan.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah CHANNEL_RC_OK.
Jika terjadi kesalahan, fungsi mengembalikan salah satu nilai berikut.
Keterangan
Fungsi VirtualChannelWrite bersifat asinkron. Ketika operasi tulis telah selesai, fungsi VirtualChannelOpenEvent Anda menerima pemberitahuan CHANNEL_EVENT_WRITE_COMPLETE. Hingga pemberitahuan diterima, pemanggil tidak boleh membebaskan atau menggunakan kembali buffer pData yang diteruskan ke VirtualChannelWrite.
Nilai yang ditentukan untuk parameter pUserData diteruskan ke fungsi VirtualChannelOpenEvent Anda saat operasi tulis selesai atau dibatalkan. Anda dapat menggunakan data ini untuk mengidentifikasi operasi tulis.
Add-in server di akhir server saluran virtual memanggil fungsi WTSVirtualChannelRead untuk membaca data yang ditulis oleh panggilan VirtualChannelWrite .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | cchannel.h |