F.74 ctThrdQueueWrite

---

Write a queue message.

Short Name

ctThrdQueueWrite

TYPE

Threading function

DECLARATION

NINT ctThrdQueueWrite(NINT qid, pVOID message, NINT msglen)

DESCRIPTION

Write a queue message to the end of the queue specified by queue handle qid. It is permissible for the message to be NULL and/or the msglen to be zero.

RETURN

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful function.
90	NQUE_ERR	Invalid qid.
92	QMRT_ERR	Queue memory error.
514	CQUE_ERR	Queue could not be closed.

See Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

EXAMPLE

See ctmtap.c for ctThrdQueueWrite examples.

LIMITATIONS

Can only be used with a ctThrd library.

SEE ALSO

ctThrdQueueClose, ctThrdQueueCount, ctThrdLIFOWrite, ctThrdQueueMlen, ctThrdQueueRead, and ctThrdQueueOpen.