INtime SDK Help
SendRtShortDataMessage
INtime SDK v7 > About INtime > INtime Kernel > Message Queues > SendRtShortDataMessage

Sends a short data message to a queue.

BOOLEAN SendRtShortDataMessage(
RTHANDLE 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 TRUE on success. Returns FALSE on failure. Call GetLastRtError() to find the failure status. Possible status values 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/rt/include/rtbase.h rt.h rt.lib
See Also