INtime SDK Help
ntxSendRtShortDataMessage
INtime SDK v7.1 > About INtime > INtime Kernel > Message Queues > 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
See Also

Message Queues