|
|
|
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 FairCom DB Error Codes for a complete listing of valid FairCom DB error values.
See also
ctThrdQueueRead, ctThrdQueueWriteDirect
