4D v13.2

SMTP_QuickSend

Home

 
4D v13.2
SMTP_QuickSend

SMTP_QuickSend 


 

SMTP_QuickSend ( hostName ; msgFrom ; msgTo ; subject ; message {; sessionParam}{; port}{; userName ; password} ) -> Function result 
Parameter Type   Description
hostName  String in Host name or IP address
msgFrom  Text in MailAddress or AddressList
msgTo  Text in MailAddress or AddressList
subject  Text in Subject
message  Text in Message
sessionParam  Longint in 0 or omitted = Do not use SSL but switchover allowed, 1 = Use SSL, 2 = Never use SSL (switchover not allowed)
port  Longint in Number of port to use
userName  Text in User name for authentication
password  Text in Password for authentication
Function result  Integer in Error Code

The SMTP_QuickSend command gives the users the ability to build and send a mail message with one command. In the event that you require greater control over your message, or the message is of a more sophisticated nature, the group of SMTP commands based on the SMTP_New command should be utilized.

hostName is the host name or IP address of the SMTP server where the message will be sent for distribution.

msgFrom is a text value containing an AddressList of one or more complete mail addresses indicating who originally sent the message. All addresses listed in the From header are visible to the recipients of the message.

msgTo contains an AddressList value of one or more complete mail addresses. The addresses identified in the msgTo header will each be sent an original copy of the message. Each recipient of the message will see any other mail addresses the message was delivered to.

subject is a text value concisely describing the topic covered in detail by the message body.

Warning: Usually, the subject of the message should not contain characters with diacritical marks (such as é, ö, etc.). However, if you want to use such “extended” characters, refer to the SMTP_SetPrefs and SMTP_Charset command descriptions.

message is a text value containing the body of the mail message. For historical reasons, the size of the message is restricted to 32 KB.

The optional sessionParam parameter sets the activation mode of the SSL protocol for the connection:

  • If you pass 0 or omit this parameter, the message will be sent in standard, non-secure mode. If the server proposes an update to SSL/TLS after authentication, the switchover is performed automatically (SSL/TLS operation in explicit mode).
  • If you pass 1, the message will be sent in SSL (synchronous mode),
  • If you pass 2, the message will be sent in standard mode but without supporting updating to SSL/TLS.

The optional port parameter specifies the SMTP port number to use for connection with the server. The most frequently used values are:

  • 25 = standard non-secure STMP port (default port when parameter is omitted)
  • 465 = SMTPS (SSL/TLS) port
  • 587 = standard (but secure) SMTP port; pass this port for connections with a MS Exchange server (explicit mode).

The optional userName and password parameters are used to authenticate the sender with the mail server. These parameters must be passed together. Note that the most secure authentication mode supported by the server will be used (as with the default mode of the SMTP_Auth command).

Here is an example of use of this command:

 $Host:="www.4d.com"
 $ToAddress:="adupont@4d.fr"
 $FromAddress:="jsmith@4d.com"
 $Subject:="Sales Report"
 $Message:="Can you send me the sales report for January 2009? Thanks."
 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;1)
 If($Error#0)
    ALERT("Error: SMTP_QuickSend"+Char(13)+IT_ErrorText($Error))
 End If

Example for using the command to send a secure message through a MS Exchange server:

 $ServerName:="exchange.4d.com"
 $MsgTo:="adupont@gmail.com"
 $MsgFrom:="a.user@4d.com"
 $Subject:="Test message"
 $Message:="This is a test for sending a message in secure mode. Please do not reply."
 $Error:=SMTP_QuickSend($ServerName;$MsgFrom;$MsgTo;$Subject;$Message;0;587;"a.user";"@!password@!")

 
PROPERTIES 

Product: 4D
Theme: IC Send Mail
Number: 88992

 
INDEX

Alphabetical list of commands

 
HISTORY 

New
Modified: 4D Internet Commands v11
Modified: 4D Internet Commands v12.1
Modified: 4D v13.2

 
SEE ALSO 

SMTP_Charset
SMTP_New
SMTP_SetPrefs