WTSVirtualChannelWrite function (wtsapi32.h)

Writes data to the server end of a virtual channel.

Syntax

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

Parameters

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

Remarks

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.
 

Requirements

Requirement Value
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

WTSVirtualChannelQuery

WTSVirtualChannelRead