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 呼叫所寫入的數據。

規格需求

另請參閱

VirtualChannelOpen

VirtualChannelOpenEvent

WTSVirtualChannelRead