Configuration Property (IMessage)
Topic Last Modified: 2006-12-01
The Configuration object for the message.
Applies To
Type Library
Microsoft CDO for Exchange 2000 Library
DLL Implemented In
CDOEX.DLL
Syntax
Property Configuration As CDO.Configuration
HRESULT get_Configuration(IConfiguration** pVal);HRESULT put_Configuration(IConfiguration* Val);
Parameters
- pVal
Returned reference to an IConfiguration Interface.
- Val
Sets the value of the Configuration property to the value of the IConfiguration Interface.
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 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.