Messaging Configuration

Messaging Configuration

The configuration information for a message is stored in an instance of the Configuration Component Object Model (COM) class. The Configuration object contains information such as the method used to deliver messages and the paths to the pickup directories for Simple Mail Transfer Protocol (SMTP) and Network News Transfer Protocol (NNTP) servers. When the Configuration object is created, Microsoft Collaboration Data Objects (CDO) fills in the default configuration information by collecting information from Microsoft Internet Information Services (IIS) and Microsoft® Outlook® Express if they are installed on the computer running CDO.

If you do not create a Configuration object, CDO creates one each time you send or post a message. For applications that send or post only a few messages, you can usually let CDO create the Configuration object for you; however, for performance reasons, you should create a single Configuration object and reuse it for each message.

Note   If neither Internet Information Services for Microsoft Windows 2000 nor Outlook Express is installed on the local machine, or if Outlook Express is not configured with an identity, you must set fields in the Configuration object specifying at a minimum the SMTP host through which to send the message.

Passwords specified in Outlook Express are not represented in the Fields collection of the Configuration object. Users specify these passwords in a dialog box when they select My Server Requires Authentication in Outlook Express. For outbound mail authentication, you can provide a write-only password using the https://schemas.microsoft.com/cdo/configuration/sendpassword field on the Configuration object. The value of the password cannot be retrieved.