|
|
|
ctSysQueueWrite
Add new data at the end of a queue.
Short Name
ctSysQueueWrite()
Type
ISAM function.
Declaration
NINT ctSysQueueWrite(NINT qhandle, pVOID message, NINT msglen)
Description
Data is placed at the end of the queue by invoking ctSysQueueWrite().
Parameter qhandle is a system queue handle returned by a call to ctSysQueueOpen(). Parameter message is a pointer to a block of memory containing arbitrary data to be placed on the queue and msglen indicates how many bytes are pointed to by message.
Return
Value |
Symbolic Constant |
Explanation |
|---|---|---|
0 |
NO_ERROR |
Successful write to the queue. |
90 |
NQUE_ERR |
Could not create queue. |
92 |
QMRT_ERR |
Queue memory error during write. |
446 |
BMOD_ERR |
Bad mode: parameter out of range. |
454 |
NSUP_ERR |
Service not supported. |
514 |
CQUE_ERR |
Queue has already been closed. |
758 |
QNOT_ERR |
Only notifications to queue. |
759 |
QUIN_ERR |
Wrong queue instance. |
See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.
Example
NINT eRet = ctSysQueueWrite(qhandle, "My message", 10);
if (eRet)
printf("ctSysQueueWrite failed with error %d\n", eRet);
Limitations
Client/Server mode only.
See also
ctSysQueueLIFOWrite
