TibrvMsg::getSendSubject()
Method
Declaration
TibrvStatus getSendSubject(const char*& sendSubject);
Purpose
Extract the subject from a message.
Remarks
The subject string is part of a message’s address information—it is not part of the message itself.
If the destination subject is not set, this method passes NULL in the return parameter.
|
Parameter |
Description |
|
|
The program supplies a variable in this parameter; the method stores the send subject in that variable. The method makes a snapshot copy of the subject string, and supplies a pointer to that snapshot within message storage. The pointer remains valid as long as the message itself remains valid in the same location. The subject pointer becomes invalid if the program destroys the message, or returns from the data callback method that determines the scope of an inbound message. For more information, see Pointer Snapshot, and Deleting Snapshot References. |
See Also
Supplementary Information for Messages in