MAPI_SendDialog()

Examples


The MAPI_SendDialog() function sends a message to the members of a specified address list. A mail dialog will be displayed for each message sent.

Syntax

MAPI_Send(address_list_ID, subject, message_text {,attachment|filelist_ID}{, reply_to_list}{, property_list})

Parameters

address_list_ID – The ID of the address list to which the message will be sent.

subject – A string specifying the subject line of the message.

message_text – A text field or variable containing the text for the message. This parameter can also be an integer specifying which attachment in the attachment list to use for the message text. The value 1 indicates the first attachment.

attachment|filelist_ID – An optional parameter that specifies the attachment or list of attachments for the message. If the parameter is a string, the string specifies the path (in generic format) of a file to attach to the message. If the parameter is a long integer, the value specified ID of the file list that contains the files to attach to the message.

reply_to_list – An optional parameter that specifies the ID of the address list to which the replies to the message will be sent.

property_list – An optional parameter that specifies the ID of the property list that contains properties to apply to the message. This allows you to apply additional MAPI properties that are not exposed through the MAPI functions.

Return value

An integer corresponding to one of the following constants:

[spacer]

MAPI_SUCCESS

MAPI_LOGIN_FAILURE

MAPI_AMBIGUOUS_RECIPIENT

MAPI_TEXT_TOO_LARGE

MAPI_ATTACHMENT_NOT_FOUND

MAPI_TOO_MANY_FILES

MAPI_ATTACHMENT_OPEN_FAILURE

MAPI_TOO_MANY_RECIPIENTS

MAPI_BAD_RECIPTYPE

MAPI_UNKNOWN_RECIPIENT

MAPI_INSUFFICIENT_MEMORY

MAPI_USER_ABORTED

MAPI_INVALID_RECIPS

MAPI_BAD_MAPI_PROPERTIES

MAPI_BODY_INDEX_OUT_OF_RANGE

MAPI_UNKNOWN


Comments

When using an attachment for the message body, the file attachment will typically be in text, HTML, or RTF format. The attachment used for the message text will not appear as an attachment for the message.


Documentation Feedback