tibrvMsg_GetReplySubject()

Function

Declaration

tibrv_status tibrvMsg_GetReplySubject(
    tibrvMsg           message,
    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.

Programs must not modify the storage in which this reply subject string resides.

Parameter	Description
`message`	Get the subject of this message.
`replySubject`	The function stores a pointer to the reply subject string in this location. The function 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 function that determines the scope of an inbound message. For more information, see Pointer Snapshot, and Deleting Snapshot References.

Parameter

Description

message

Get the subject of this message.

replySubject

The function stores a pointer to the reply subject string in this location.

The function 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 function that determines the scope of an inbound message. For more information, see Pointer Snapshot, and Deleting Snapshot References.

tibrvMsg_GetReplySubject()

Declaration

Purpose

Remarks

See Also