This documentation is archived and is not being maintained.

Configuration Property

Exchange Server 2003

Configuration Property

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The Configuration object for the message.

Applies To

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In



        [Visual Basic]Property Configuration As CDO.Configuration
        [C++]HRESULT get_Configuration(IConfiguration** pVal);
HRESULT put_Configuration(IConfigurationVal);


Returned reference to an IConfiguration Interface.
Sets the value of the Configuration property to the value of the IConfiguration Interface.


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 Component Object Model (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 a 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 want 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.