INtime SDK Help
ntxSendRtLongDataMessage
INtime SDK v7.1 > About INtime > INtime Kernel > Message Queues > ntxSendRtLongDataMessage

Sends a long data message to a queue.

BOOLEAN ntxSendRtLongDataMessage(
NTXHANDLE hQueue,
LPVOID msg,
DWORD msgLength,
DWORD msWait);

Parameters

hQueue 
A handle for a valid queue object.
msg 
A pointer to the data message.
msgLength
The number of bytes in the data message.
msWait 
The number of milliseconds to wait for the message to be entirely transferred. The calling thread sleeps until the number of milliseconds elapses, or the entire long message has been completely transferred. If the send times out, then the transaction is canceled internally and the sender may reuse the message buffer.

Returns

Returns TRUE on success. Returns FALSE on failure. Call ntxGetLastRtError() to find the failure status. Possible status values include:

 

E_EXIST The hQueue parameter does not refer to an existing object
E_TYPE The hQueue parameter does not refer to a valid message queue object.
E_CANCELLED The receiver canceled the request to send the long message.
E_BAD_ADDR The msg parameter is not a valid pointer.
E_TIME The operation timed out or the illegal timeout value 0 was given for the msWait parameter.
E_PARAM The msgLength parameter is less than the message threshold for this queue, or the time value 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