ec_message_cowref

ec_message_cowref — Create a copy-on-write reference to an existing message

#include "ec_message.h"

| ec_message * **ec_message_cowref** ( | sm); |   |

ec_message * <var class="pdparam">sm</var>;

This reference page was automatically generated from functions found in the header files in the development branch. The function described here may not exist in generally available versions of Momentum, and may change in behavior when it is generally available. Consult your vendor for definitive advice on the use of this function.

Create a copy-on-write reference to an existing message.

This is used during message reception to efficiently handle multi-recipient mail. The newly created message has a unique queue id that is distinct from the source message.

Parameters

Return Values

a new message that holds copy-on-write references to the components of the source message, sm.