ntxSendRtLongDataMessage

Sends a long data message to a queue.

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

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 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.

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