Microsoft KB Archive/238776

= XCLN: MAPIsend tool Usage and Error Codes =

Article ID: 238776

Article Last Modified on 1/25/2007

-

APPLIES TO


 * Microsoft Exchange Server 4.0 Standard Edition
 * Microsoft Exchange Server 5.0 Standard Edition
 * Microsoft Exchange Server 5.5 Standard Edition
 * Microsoft Outlook 2000 Standard Edition
 * Microsoft Outlook 97 Standard Edition
 * Microsoft Outlook 98 Standard Edition

-



This article was previously published under Q238776



SUMMARY
This article describes the command-line usage and error codes of the MAPIsend tool (Mapisend.exe) located on the Microsoft BackOffice Resource Kit, Second Edition. The MAPIsend tool allows a user to send Messaging Application Programming Interface (MAPI) messages from a command-line.



MORE INFORMATION
The following command-line parameters can be used with the MAPIsend tool:


 * -u profile name of sender (user mailbox) Profile name should be exactly the same as listed in the profile.
 * -p login password
 * -i interactive login (prompts for profile and password)
 * -r recipient(s) Multiple recipients must be separated by a semicolon and must not be ambiguous in default address book.NOTE: This is an important distinction. To test, open a MAPI client such as Microsoft Outlook, and compose a new message. Enter the recipient's name and click Check Names (ALT+K). If the name is resolved to a single recipient, the alias is not ambiguous. If Check Names returns multiple addresses, the alias is considered ambiguous.


 * -c specifies mail copy list (cc: list)
 * -s subject line
 * -m specifies contents of the mail messageNOTE: This is where the message body is inserted


 * -t specifies text file for contents of the mail messageNOTE: The MAPIsend tool can be directed to use a specific text file as the content of the message.


 * -f path and file name(s) to attach to message
 * -v generates verbose output
 * -? prints this message

Examples
mapisend -u "Bill Walker-Test2" -p password -r wwalker -c wwalker -s Test -m Message -f c:\test.txt -v This sends a message with a subject of "Test" and a body of "Message" to the mailbox, wwalker. The message is sent to wwalker using the profile called "Bill Walker-Test2" with a password of "password" and attaches a file called "test.txt" from the root of drive C and displays verbose information.

mapisend -i -r wwalker -s Interactive2 This prompts the user for a profile, and sends a message with a subject of "Interactive2" to wwalker with no body text.

Error Codes
The following is a list of error codes returned by MAPIsend:

1 user abort

2 session failure

3 login failure

4 disk full

5 insufficient memory

6 access denied

7 too many sessions

8 too many files

9 too many recipients

10 attachment not found

11 attachment open failure

12 attachment write failure

13 unknown recipient

14 bad recipient type

15 no messages

16 invalid message

17 text too large

18 invalid session

19 type not supported

20 ambiguous recipient

21 message in use

22 network failure

23 invalid edit fields

24 invalid recipients

25 not supported

For more information on the MAPIsend tool, please refer to the Exchange Help files shipped with the Microsoft BackOffice Resource Kit, Second Edition.

Keywords: kbinfo KB238776

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.