WTSVirtualChannelWrite function (wtsapi32.h)

Writes data to the server end of a virtual channel.


BOOL WTSVirtualChannelWrite(
  [in]  HANDLE hChannelHandle,
  [in]  PCHAR  Buffer,
  [in]  ULONG  Length,
  [out] PULONG pBytesWritten


[in] hChannelHandle

Handle to a virtual channel opened by the WTSVirtualChannelOpen function.

[in] Buffer

Pointer to a buffer containing the data to write to the virtual channel.

[in] Length

Specifies the size, in bytes, of the data to write.

[out] pBytesWritten

Pointer to a variable that receives the number of bytes written.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.


Note  WTSVirtualChannelWrite is not thread safe. To access a virtual channel from multiple threads, or to do asynchronous IO through a virtual channel, use WTSVirtualChannelQuery with WTSVirtualFileHandle.


Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header wtsapi32.h
Library Wtsapi32.lib
DLL Wtsapi32.Dll

See also