This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Send send HTML encoded email once a connection has been made to your SMTP server after calling SMTP_Connect.
Syntax
ErrorCode = SMTP_SendHTML( To, Cc, BCc, Subject, Message, Images, AltText, Attach, Options )
Returns
Number.
If ErrorCode < 0 (Zero) means failure. Use SMTP_GetError to return error description of error code.
Parameters
Name |
Type |
Optional |
Meaning |
To |
String |
No |
Recipient, separated by semi-colons |
Cc |
String |
No |
CC list, separated by semi-colons |
BCc |
String |
No |
BCC list, separated by semi-colons |
Subject |
String |
No |
Subject text (max 256 chars) |
Message |
String |
No |
Mail message content or message filename from which to load message content. If the first character of the message is a '@', then it is considered as the filename which contains the message to send. Example: "@C:\Temp\Message.html" |
Images |
String |
No |
Contains the filenames of images that are to be embedded in the email message. The first image must be referenced in the text of the HTML encode email message as <IMG SRC="cid:message-root.1"> The second image (if any) must be referenced as <IMG SRC="cid:message-root.2"> continuing in this way for all embedded images. |
AltText |
String |
No |
Used to provide a plain ASCII text equivalent of the message for those email clients that cannot decode HTML |
Attach |
String |
No |
File attachment list. It may contain one or more attachments, separated by semi-colons, with no embedded spaces. |
Options |
Numeric |
No |
Not used but mandatory |
Remarks
Note that all email addresses (in To, CC, and BCC strings) must be bracketed, and the CC and BCC strings may contain multiple email addresses, separated by semi-colons. .
Restrictions
Message maximum size is 1 Mega Byte. If more room is needed, consider using external file message option.
See also
Examples