CdoSendUsing Enum
Topic Last Modified: 2007-11-01
The CdoSendUsing enumeration is used to set the sendusing Field when you are configuring the Message object. The sendusing Field uses cdoSendUsingPickup if a local Simple Mail Transfer Protocol (SMTP) service is available on the computer.
Type Library
Microsoft CDO for Exchange 2000 Library
DLL Implemented In
CDOEX.DLL
Values
| Name | Value | Description |
|---|---|---|
cdoSendUsingPickup |
1 |
Send the message by using the local SMTP service pickup directory. |
cdoSendUsingPort |
2 |
Send the message by using the network (SMTP over the network). |
cdoSendUsingExchange |
3 |
Send the message by using the Microsoft Exchange mail submission Uniform Resource Identifier (URI). This URI is found in the user's urn:schemas:httpmail:sendmsg mailbox folder property. |
Remarks
If you specify the value cdoSendUsingPickup, you can specify the pickup directory by using the smtpserverpickupdirectory Field.
Note
You must either specify the pickup directory or run your application under an account that has explicit rights to read the Internet Information Services (IIS) metabase. For more information, see Specifying the Pickup Directory.
If you specify the value cdoSendUsingPort, you will either need the default values that are provided by the default Microsoft Outlook Express configuration on the local computer, or you must set the following fields manually:
If you specify cdoSendUsingExchange, the following table lists the fields in the Configuration object that you must specify.
Configuration object fields to specify for cdoSendUsingExchange
| Field | Description |
|---|---|
The URL to the user's mailbox. If this property is not set, the mailbox URL is constructed by searching the Active Directory directory service for the user who is specified in the sendusername property and identifying the Exchange server for the user. |
|
A Microsoft ActiveX Data Objects (ADO) Connection object bound to the user's mailbox store. If this connection is not specified, a new connection is created to send the message. If the sending object (for example, a Message object) is currently bound to an item, the binding is replaced when the new connection is created. If a Connection object is specified in this property, the binding of the current object is not changed, and the object uses this connection to send the message. |
|
The user principal name (UPN) or URL in the form user@domain.tld or mailto:user@domain.tld. You can also specify the user by using the Microsoft Windows NT 4.0 format, such as DOMAIN\User. If the user's mailbox URL is not specified in the mailboxurl configuration property, this UPN is used to search Active Directory. |
|
The user's password, which is used to authenticate with remote servers when sending messages, and to authenticate with Active Directory when searching for user information. |
For more information, see https://schemas.microsoft.com/cdo/configuration/ Namespace.
The default cdoSendUsingPickup method is only supported on computers that are running Microsoft Exchange Server 2007 that have the Mailbox and Hub Transport server roles installed.
If you do not specify a send using method, the Exchange server will try to find a pickup directory on the local computer. If the local computer is a Mailbox server, the SMTP service does not exist on the computer and therefore the pickup directory does not exist. In this case, if you use the default settings, you will receive the following error message when you send a message: The "SendUsing" configuration value is invalid.
If a cdoSendUsingPickup is supplied on a Mailbox server, and a pickup path is not specified, you will receive the following error message when you send a message: The pickup directory path is required and was not specified.
To resolve this issue, you can do one of the following:
- Share the pickup directory on a Hub Transport server and specify this pickup directory in the Collaboration Data Objects for Exchange 2000 Server (CDOEX) message configuration.
- Use a different send using method.
- Install the Hub Transport server role on the Mailbox server that will be sending messages by using cdoSendUsingPickup.