F.62 ctThrdLIFOWrite

---

Write a message at the beginning of a queue.

Short Name

ctThrdLIFOWrite

TYPE

Threading function

DECLARATION

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

DESCRIPTION

Write a message at the beginning of the queue specified by 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.

LIMITATIONS

Can only be used with a ctThrd library.

SEE ALSO

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