%HI_MAPI_SendMail function

Function

The function %HI_MAPI_SendMail opens a default e-mail client and prepares automatically the message to be sent.

Declaration

INT %HI_MAPI_SendMail(
   TEXT in sendTo,
   TEXT in sendCc,
   TEXT in sendBcc,
   TEXT in subject,
   TEXT in text,
   TEXT in attaches
 )

Parameters

sendTo	Receivers of the mail separated by comma (section send TO).
sendCc	Receivers of the mail separated by comma (section send CC).
sendBcc	Receivers of the mail separated by comma (section send BCC).
subject	Subject of the message.
text	Text of the message.
attaches	Paths to attaches separated by comma.

Description

The return value is of Int type (positive numbers represent the errors which are defined in MSDN for MAPISendMail). There are allowed return values:

Code	MAPI constant
0	SUCCESS_SUCCESS
1	MAPI_E_USER_ABORT
2	MAPI_E_FAILURE
3	MAPI_E_LOGIN_FAILURE
4	MAPI_E_DISK_FULL
5	MAPI_E_INSUFFICIENT_MEMORY
6	MAPI_E_ACCESS_DENIED
8	MAPI_E_TOO_MANY_SESSIONS
9	MAPI_E_TOO_MANY_FILES
10	MAPI_E_TOO_MANY_RECIPIENTS
11	MAPI_E_ATTACHMENT_NOT_FOUND
12	MAPI_E_ATTACHMENT_OPEN_FAILURE
13	MAPI_E_ATTACHMENT_WRITE_FAILURE
14	MAPI_E_UNKNOWN_RECIPIENT
15	MAPI_E_BAD_RECIPTYPE
16	MAPI_E_NO_MESSAGES
17	MAPI_E_INVALID_MESSAGE
18	MAPI_E_TEXT_TOO_LARGE
19	MAPI_E_INVALID_SESSION
20	MAPI_E_TYPE_NOT_SUPPORTED
21	MAPI_E_AMBIGUOUS_RECIPIENT
22	MAPI_E_MESSAGE_IN_USE
23	MAPI_E_NETWORK_FAILURE
24	MAPI_E_INVALID_EDITFIELDS
25	MAPI_E_INVALID_RECIPS
26	MAPI_E_NOT_SUPPORTED
-1	an internal error (e.g. missing library mapi32.dll)

Note

The function was tested for Windows XP (Lotus Notes and Microsoft Outlook Express) and Windows Vista (Lotus Notes).

Example

 ENTRY SEND_MAIL_OnClick
  INT _retCode
  _retCode := %HI_MAPI_SendMail("bconto@ipesoft.sk", "", "", "%HI_MAPI_SendMail", "It was sent through the function", "d:\eagle7_current\c_d2000_workbook.cmd")
 END SEND_MAIL_OnClick