Open topic with navigation

TIBCO Rendezvous® 8.8.0

# tibrvMsg_CreateCopy()

Function

## Declaration

    tibrv_status tibrvMsg_CreateCopy(
       const tibrvMsg   message
       tibrvMsg*        copy);

## Purpose

Copy a message.

## Remarks

The copy is completely independent of the original message. Pointer data in fields are independent copies of the values.

This function copies only the data within the fields of the message. The copy does not include any supplementary information—for example, address information or certified delivery information. (Programs can explicitly add supplementary information to the copy using functions such as tibrvMsg_SetSendSubject().)

This function allocates the storage for the copy. The duration of the copy is independent of the original message.

A program owns the messages that it creates, and must destroy them to reclaim the storage. That is, each call to this function must be paired with a call to tibrvMsg_Destroy().

Parameter | Description
`message` | Copy this message.
`copy` | The function stores a pointer to the new copy in this location.

## See Also

tibrvMsg_Destroy()

tibrvMsg_SetReplySubject()

tibrvMsg_SetSendSubject()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2025. Cloud Software Group, Inc. All Rights Reserved.