TibrvMsg::isDetached()
Method
Declaration
tibrv_bool isDetached();
Purpose
Determine the ownership of the message.
Remarks
Ownership of a message belongs either to Rendezvous software, or to your program.
When Rendezvous software owns a message, the message is considered attached. Rendezvous software automatically destroys the message and reclaims its storage. For example, Rendezvous software creates an object representing an inbound message, and presents it as a parameter to a listener callback method; when the callback method returns, Rendezvous software destroys the message.
A program can explicitly detach an inbound message. Thereafter, the program owns the message, and assumes the responsibility to destroy it and reclaim its storage.
When a program creates a message object, the program owns that message, along with the responsibility to destroy it.
This method determines the ownership of a message. It returns TIBRV_TRUE when the program owns the message; it returns TIBRV_FALSE when Rendezvous software owns the message.