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