SysPipeWindowsPeek
(FUN)
FUNCTION SysPipeWindowsPeek : RTS_IEC_RESULT
Read without removing the contents of a pipe. Copies data from a named or anonymous pipe into a buffer without removing it from the pipe. It also returns information about data in the pipe.
- InOut:
Scope
Name
Type
Comment
Return
SysPipeWindowsPeek
RTS_IEC_RESULT
- Error code:
ERR_OK: Success
ERR_NET_NOTCONNECTED: ERROR_PIPE_NOT_CONNECTED
ERR_END_OF_OBJECT: ERROR_BROKEN_PIPE
Input
hPipe
RTS_IEC_HANDLE
Handle to a SysPipeWindows instance
pbyBuffer
POINTER TO BYTE
A pointer to a buffer that receives data read from the pipe. This parameter can be NULL if no data is to be read.
uxSize
__UXINT
The size of the buffer specified by the lpBuffer parameter, in bytes. This parameter is ignored if lpBuffer is NULL.
puxBytesRead
POINTER TO __UXINT
A pointer to a variable that receives the number of bytes read from the pipe. This parameter can be NULL if no data is to be read
puxTotalBytesAvail
POINTER TO __UXINT
A pointer to a variable that receives the total number of bytes available to be read from the pipe. This parameter can be NULL if no data is to be read.
puxBytesLeftThisMessage
POINTER TO __UXINT
A pointer to a variable that receives the number OF bytes remaining in this message. This parameter will be zero for byte-type named pipes or for anonymous pipes. This parameter can be NULL if no data is to be read.