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 c-tree Plus Error Codes for a complete listing of valid c-tree Plus 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.