F.73 ctThrdQueueReadDirect

---

Read a queue message pointer.

Short Name

ctThrdQueueReadDirect

TYPE

Threading Function

DECLARATION

NINT ctThrdQueueReadDirect(NINT qid, pVOID msgadr,

pNINT pmsglen, LONG timeout)

DESCRIPTION

ctThrdQueueReadDirect places the address of the next message from queue qid into msgadr, and places the length of the message in pmsglen. ctThrdQueueReadDirect does not copy the message contents.

Note: Your application is responsible for managing the buffers used in the read and write calls. To avoid memory/buffer errors, FairCom recommends using either the original Queue read/write calls or the new direct calls, but not mixing calls from both pairs.

The return value is an error indicator.

RETURN

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful convert.
90	NQUE_ERR	Invalid qid.
156	NTIM_ERR	Timeout 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.

SEE ALSO

ctThrdQueueRead and ctThrdQueueWriteDirect.