ntxSendRtShortDataMessage

Sends a short data message to a queue.

BOOLEAN ntxSendRtDataShortMessage(
    NTXHANDLE hQueue,
    LPVOID msg,
    DWORD msgLength);

Parameters

hQueue: A handle for a valid queue object.
msg: A pointer to a data message.
msgLength: The number of bytes to send in the short data message.

Returns

Returns a non-zero value on success, or else FALSE to indicate failure. The failure status is returned from GetLastRtError(). Status codes returned from this call include:

E_EXIST	The `hQueue` parameter does not refer to an exiting object
E_TYPE	The `hQueue` parameter does not refer to a valid queue object
E_PARAM	The `msgLength` parameter is greater than the message threshold for the queue.
E_LIMIT	The queue object does not have enough space to accept this message.
E_BUSY	An internal error occurred in the queue usually caused by too many threads accessing the queue at the same time or by network load and the message could not be sent.
E_BAD_ADDR	The pointer to the data message is invalid.

Requirements

Versions	Defined in	Include	Link to
INtime 5.0	intime/nt/include/ntx.h	ntx.h	ntx.lib, ntxext.lib

Parameters

Returns

Requirements

Message Queues