Please enable JavaScript to view this site.

thinBasic Help Manual

Navigation: ThinBASIC Modules > SMTP

SMTP_SendEmail

Scroll Prev Top Next More

* * HELP & MANUAL PREMIUM PACK 4 DEMO VERSION * *

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 email once a connection has been made to your SMTP server after calling SMTP_Connect.

 

Syntax

 

ErrorCode = SMTP_SendEmail( To, Cc, BCc, Subject, Message, 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.txt"

Attach

String

No

File attachment list.

It may contain one or more attachments, separated by semi-colons, with no embedded spaces. If the function

  SMTP_SetOption(%SMTP_ENABLE_IMAGE, 1)

has been called previously, attachment files ending with ".GIF", ".BMP", or ".TIF" are attached as image types rather than regular images.  This allows some email clients to display the images.

Options

Numeric

No

Not used but mandatory. Just enter zero

 

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 ii 1 Mega Byte. If more room is needed, consider using external file message option.

 

See also

 

Examples

 

 

Created with Help+Manual 8 and styled with Premium Pack Version 4 © by EC Software