Configuration Property

[This is preliminary documentation and subject to change.]

The Configuration object for the message.

[Visual Basic]
Property Configuration as IConfiguration
[C++]
HRESULT get_Configuration(IConfiguration** pVal);
HRESULT put_Configuration(IConfiguration* Val);
[IDL]
HRESULT [propget] Configuration([out,retval] IConfiguration** pVal);
HRESULT [propput] Configuration([in] IConfiguration* Val);

Remarks

The configuration settings used for the current message are contained in the Configuration object (exposing the IConfiguration interface) referenced by this property. To change the settings, you can retrieve a reference to the object and modify the settings using the IConfiguration.Fields collection, or you can create a new instance of the Configuration COM class, modify the settings, and set the object reference to the Configuration property.

If you do not explicitly set or modify the associated Configuration object, the message is processed using a default configuration. For optimal performance, it is recommended that you create an Configuration object, set the configuration fields manually, and set the object to the Configuration property on each Message object.

You cannot replace the default configuration. If you wish to alter configuration information for messages, you must modify the fields in each object's associated Configuration object. If a single configuration is to be used for a set of messages, you can simply create a new Configuration object, modify the fields, and then reference this Configuration object in all the intended messages.