A string or
One of the keywords
name is the pipe name. It can contain any character except
#\\ (according to the MSDN). For successful connection another process must have already created a pipe with that name, with the right input/output direction and permissions for the caller of
connect-to-named-pipe, and tried to connect to it but has not succeeded yet. In LispWorks this is done by open-named-pipe-stream. The Windows function is
direction specifies the direction of input/output. It needs be allowed by the pipe (in inverse, that is if
connect-to-named-pipe gets direction
:input then the pipe must have been opened for output, for example by calling open-named-pipe-stream with direction
:io). The default value of direction is
errorp specifies what to do in case of failure. If it is non-nil (the default), an error is signaled. If it is
connect-to-named-pipe returns stream
nil, keyword is a descriptive keyword, and condition is an error condition. keyword can be one of:
There is at least one named pipe with this name, but all are already connected.
There is already a named pipe with this name, but it denies access. That may be either because the permissions of the named pipe do not allow the connection, or because other security features of the host system block the connection.
An unknown error.
LispWorks User Guide and Reference Manual - 13 Feb 2015