Message.CloneByRef Method (IMessage, MessageCloneOptions)

Clones a reference of a message. Use this method to create a copy of an existing message, especially one of a different type, into this message.

Important: This method is not the same as nor does it behave the same as Clone. That is why this message type does not implement ICloneable. It is not recommended that any code outside of Messaging core code use this function without understanding how it works, what its limitations are, and why it's being used.

Namespace:   Microsoft.ConfigurationManagement.Messaging.Framework
Assembly:  Microsoft.ConfigurationManagement.Messaging (in Microsoft.ConfigurationManagement.Messaging.dll)

Syntax

public void CloneByRef(
    IMessage sourceMessage,
    MessageCloneOptions options
)

public:
void CloneByRef(
    IMessage^ sourceMessage,
    MessageCloneOptions options
)

Public Sub CloneByRef (
    sourceMessage As IMessage,
    options As MessageCloneOptions
)

Parameters

• sourceMessage
  Type: Microsoft.ConfigurationManagement.Messaging.Framework.IMessage

  Source message to clone into this message.

• options
  Type: Microsoft.ConfigurationManagement.Messaging.Framework.MessageCloneOptions

  Options that affect cloning.

See Also

CloneByRef Overload
Message Class
Microsoft.ConfigurationManagement.Messaging.Framework Namespace

Return to top