This method stores a pointer to caller provided data in the message for later retrieval using the p6IMessage::getData() method.
A cleanup routine can be registered with the message using the setCleanupRoutine() method to cleanup the allocated data before the message is destroyed.
- Parameters
-
pData | [ in ] A pointer to allocated to be passed along with the message. |
- Returns
Success | eOk | Life is good. |
Failure | eTooBig | The data is too large to fit in the message's internal storage area |
eTooSmall | pData is NULL and cData is 0. The size of the messages internal storage area is returned in cData. |
eInvalidArg | pData is non-NULL, but cData == 0 or vice versa |