Article ID: 287573 - View products that this article applies to.
This article was previously published under Q287573
For a Microsoft Outlook 2000 version of this article, see 197782
For a Microsoft Outlook 98 version of this article, see 181991
For a Microsoft Outlook 97 version of this article, see 172958
This article describes how to use command line switches to create a new e-mail message that is pre-addressed (with the To field filled in automatically). You can do this in one of the following ways:
Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.
How to use a desktop shortcutTo create a shortcut on your Windows desktop that automatically creates a new pre-addressed e-mail message, follow these steps:
"C:\Program Files\Microsoft Office\Office\Outlook.exe" /c ipm.note.myform /m <full e-mail name>
How to use the "Shell" commandTo automatically create a new pre-addressed Outlook e-mail message by using the Shell command, follow these steps:
NOTE: Using the Shell command is very restrictive. You can better automate the contents of a new e-mail message with Visual Basic for Applications or VBScript.
Single command-line string for a message with subject and bodyNOTE: The procedures that are outlined in this section assume that the you are familiar with creating the type of objects listed in the implementation list.
In order to create a preformatted and pre-addressed e-mail message, it is necessary to build a command-line string with the following parameters:
mailto:<to email>?cc=<cc email>&bcc=<bccWhere the following variable definitions apply:
mail>&subject=<subject text>&body=<body text>
Note the position of the question mark (?) and ampersand (&) characters in the command-line syntax.
Variable Field Entry -------------------------------------------------------------- <to e-mail> e-mail address to appear in the To field <cc mail> e-mail address to appear in the CC field <bcc mail> e-mail address to appear in the BCC field <subject> text to appear in the Subject field <body text> text to appear in the Body of the message
In addition to the field designations, you must use ASCII hexadecimal equivalents as variables for punctuation characters. The following variables are used to represent commonly used characters:
Space ( ) %20The following is an example of a command-line that populates the To, the Subject, and the Body fields in a new e-mail message:
Comma (,) %2C
Question Mark (?) %3F
Period (.) %2E
Exclamation Point (!) %21
Colon (:) %3A
Semicolon (;) %3B
mailto:firstname.lastname@example.org&subject=Hello%20World%21&body=How%20are%20you%2C%20John%3FThis command-line yields the following information:
Recipient: email@example.com Subject: Hello World! Body: How are you, John?
Uses of the Command line StringThis command line string may be used in the following implementations: