TibrvMsg::getReplySubject()

Method

Declaration

TibrvStatus getReplySubject(const char*& replySubject);

Purpose

Extract the reply subject from a message.

Remarks

The reply 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

replySubject

The program supplies a variable in this parameter; the method stores the reply subject in that variable.

The method makes a snapshot copy of the reply 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 reply 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

TibrvMsg::setReplySubject()

Supplementary Information for Messages in TIBCO Rendezvous Concepts