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