VIRTUALCHANNELWRITE 回呼函式 (cchannel.h)
將數據從虛擬通道的用戶端端傳送至伺服器端上的夥伴應用程式。
遠端桌面服務會在傳遞至 VirtualChannelEntry 進入點的 CHANNEL_ENTRY_POINTS 結構中，提供 VirtualChannelWrite 函式的指標。
語法
VIRTUALCHANNELWRITE Virtualchannelwrite;
UINT VCAPITYPE Virtualchannelwrite(
[in] DWORD openHandle,
[in] LPVOID pData,
[in] ULONG dataLength,
[in] LPVOID pUserData
)
{...}
參數
[in] openHandle
虛擬通道的句柄。 這是 VirtualChannelOpen 函式的 pOpenHandle 參數中所傳回的句柄。
[in] pData
包含要寫入之數據的緩衝區指標。
[in] dataLength
指定要寫入之 pData 緩衝區中的數據位元組數目。
[in] pUserData
應用程式定義的值。 當寫入作業完成或取消時，此值會傳遞至 VirtualChannelOpenEvent 函式。
傳回值
如果函式成功，傳回值會CHANNEL_RC_OK。
如果發生錯誤，函式會傳回下列其中一個值。
備註
VirtualChannelWrite 函式是異步的。 寫入作業完成時， VirtualChannelOpenEvent 函式會收到CHANNEL_EVENT_WRITE_COMPLETE通知。 在收到該通知之前，呼叫端不得釋放或重複使用傳遞至 VirtualChannelWrite 的 pData 緩衝區。
為 pUserData 參數指定的值會在寫入作業完成或取消時傳遞至 VirtualChannelOpenEvent 函式。 您可以使用此資料來識別寫入作業。
虛擬通道伺服器端的伺服器載入宏會呼叫 WTSVirtualChannelRead 函式，以讀取 VirtualChannelWrite 呼叫所寫入的數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | cchannel.h |