|
|
|
ctSysQueueLIFOWrite
Add new data at the beginning of a queue.
Short Name
ctSysQueueLIFOWrite()
Type
ISAM function.
Declaration
NINT ctSysQueueLIFOWrite(NINT qhandle, pVOID message, NINT msglen)
Description
Data is placed at the beginning of the queue by invoking ctSysQueueLIFOWrite(). This is similar to a stack operation.
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 = ctSysQueueLIFOWrite(qhandle, "My message", 10);
if (eRet)
printf("ctSysQueueLIFOWrite failed with code %d\n", eRet);
Limitations
Client/Server mode only.
See also
ctSysQueueWrite
