The SetNamedPipeHandleState function sets the read mode and the blocking mode of the specified named pipe. If the specified handle is to the client end of a named pipe and if the named pipe server process is on a remote computer, the function can also be used to control local buffering.
BOOL SetNamedPipeHandleState(
HANDLE hNamedPipe, |
// handle of named pipe |
LPDWORD lpMode, |
// address of new pipe mode |
LPDWORD lpMaxCollectionCount, |
// address of max. bytes before remote transmission |
LPDWORD lpCollectDataTimeout |
// address of max. time before remote transmission |
); |
Mode |
Description |
PIPE_READMODE_BYTE |
Data is read from the pipe as a stream of bytes. This mode is the default if no read-mode flag is specified. |
PIPE_READMODE_MESSAGE |
Data is read from the pipe as a stream of messages. The function fails if this flag is specified for a byte-type pipe. |
One of the following wait modes can be specified:
Mode |
Description |
PIPE_WAIT |
Blocking mode is enabled. This mode is the default if no wait-mode flag is specified. When a blocking mode pipe handle is specified in the ReadFile, WriteFile, or ConnectNamedPipe function, operations are not finished until there is data to read, all data is written, or a client is connected. Use of this mode can mean waiting indefinitely in some situations for a client process to perform an action. |
PIPE_NOWAIT |
Nonblocking mode is enabled. In this mode, ReadFile, WriteFile, and ConnectNamedPipe always return immediately. Note that nonblocking mode is supported for compatibility with Microsoft® LAN Manager version 2.0 and should not be used to achieve asynchronous input and output (I/O) with named pipes. |
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
ConnectNamedPipe, CreateFile, CreateNamedPipe, GetNamedPipeHandleState, ReadFile, WriteFile
file: /Techref/os/win/api/win32/func/src/f80_9.htm, 6KB, , updated: 2000/4/7 11:19, local time: 2024/11/27 21:25,
52.15.170.196:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://massmind.org/techref/os/win/api/win32/func/src/f80_9.htm"> SetNamedPipeHandleState</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Welcome to massmind.org! |
.