Named Pipe

The functions in the named pipe category control interprocess communication (IPC) for named pipes. The functions can be processed only on a remote server that has interprocess communication shares.

DOS supports only client processes; a pipe already must have been created and connected to on a remote server. Child processes inherit the open file handles of the parent processes. DOS supports asynchronous reading and writing of named pipes, as long as the pipe already is created and connected.

DosReadAsyncNmPipe and DosWriteAsyncNmPipe are DOS named pipe APIs that are not used by the OS/2 program. DosReadAsync is the OS/2 equivalent of DosReadAsyncNmPipe, and DosWriteAsync is the OS/2 equivalent of DosWriteAsyncNmPipe. These companion APIs perform the same functions.

Note: The FAPI replacement library routine for DosOpen provides support for DASD opens (open mode flag 0x8000). Since DOS does not support this operation, pipe operations on this type of file handle return ERROR_INVALID_HANDLE, rather than ERROR_BAD_PIPE.

ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г FUNCTION Г DIFFERENCES FOR DOS Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosBufReset Г Returns ERROR_BROKEN_PIPE, if the handle is to Г
Г Г a named pipe that already has been closed. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosCallNmPipe Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosClose Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosDupHandle Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosOpen Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosPeekNmPipe Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosQFHandState Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosQHandType Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosQNmPHandState Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosQNmPipeInfo Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosRead Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosReadAsyncNmPipe (DOS Г This is a DOS-unique API. Г
Г only) Г Г
Г Г The second DosReadAsyncNmPipe parameter points Г
Г Г to Async Notification Routine (pANR); in Г
Г Г DosReadAsync, it points to RamSemaphore. Г
Г Г Although their names are different, both pANR Г
Г Г and RamSemaphore are post-routine addresses Г
Г Г used to signal the caller that the read opera- Г
Г Г tion is complete. Г
Г Г Г
Г Г NOTE: If the ERROR_NOT_ENOUGH_MEMORY code is Г
Г Г returned, either reduce the size of the Г
Г Г cbBuf parameter, or increase the extra Г
Г Г heap parameter in the NETWORK.INI file. Г
Г Г Г
Г Г For an example of a call to Г
Г Г DosReadAsyncNmPipe, see Examples. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosSetFHandState Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosSetNmPHandState Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosTransactNmPipe Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosWaitNmPipe Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosWrite Г None Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г DosWriteAsyncNmPipe (DOS Г This is a DOS-unique API. Г
Г only) Г Г
Г Г The second DosWriteAsyncNmPipe parameter Г
Г Г points to Async Notification Routine (pANR); Г
Г Г in DosWriteAsync, it points to RamSemaphore. Г
Г Г Although their names are different, both pANR Г
Г Г and RamSemaphore are post-routine addresses Г
Г Г used to signal the caller that the write oper- Г
Г Г ation is complete. Г
Г Г Г
Г Г NOTE: If the ERROR_NOT_ENOUGH_MEMORY code is Г
Г Г returned, either reduce the size of the Г
Г Г cbBuf parameter, or increase the extra Г
Г Г heap parameter in the NETWORK.INI file. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

[Back] [Next]