Open a named pipe and start a thread with the given attributes.

Synopsis

Declared in <balb_pipecontrolchannel.h>

int
start(
    char const* pipeName,
    bslmt::ThreadAttributes const& attributes);

Description

Open a named pipe having the specified pipeName, and start a thread to read messages and dispatch them to the callback specified at construction, using the specified attributes of the background processing thread. Return 0 on success, and a non‐zero value otherwise. In particular, return a non‐zero value if the pipe cannot be opened or if it is detected that another process is reading from the pipe. pipeName must be of the types const char *, char *, bsl::string, std::string, std::pmr::string (if supported), or bslstl::StringRef.

Return Value

0 on success, and a non‐zero value otherwise

Parameters

Name

Description

pipeName

name of the named pipe to open

attributes

attributes of the background processing thread

Created with MrDocs