|
|
|
ctThrdQueueOpen
Open a message queue.
Short Name
ctThrdQueueOpen()
Type
Threading function
Declaration
NINT ctThrdQueueOpen()
Description
ctThrdQueueOpen() opens a queue returning a small queue handle used as the queue identifier in the other queue calls. Any number of queues may be opened.
Return
ctThrdQueueOpen() returns the queue handle. On failure, it returns the error code as a negative value. Typically a queue open will fail only if insufficient memory exists for the queue control structures.
Value |
Symbolic Constant |
Explanation |
|---|---|---|
0 |
NO_ERROR |
Successful function. |
10 |
SPAC_ERR |
Too much space required. |
See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.
Example
See ctmtap.c for ctThrdQueueOpen() examples.
Limitations
Can only be used with a ctThrd library.
See also
ctThrdQueueClose, ctThrdQueueCount, ctThrdLIFOWrite, ctThrdQueueMlen, ctThrdQueueRead, ctThrdQueueWrite
