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