Difference between revisions of "MAILOPEN()"

From Lianjapedia
Jump to: navigation, search
(Description)
 
(One intermediate revision by the same user not shown)
Line 20: Line 20:
 
|<expC3>||Yes||None||The password for the user name.  For ESMTP, this must be [[BASE64_ENCODE()|Base64 encoded]].
 
|<expC3>||Yes||None||The password for the user name.  For ESMTP, this must be [[BASE64_ENCODE()|Base64 encoded]].
 
|-
 
|-
|valign="top"|<expC4>||valign="top"|No||valign="top"|POP3||The mail protocol type.  POP3, SMTP and ESMTP* are the currently supported protocols.
+
|valign="top"|<expC4>||valign="top"|No||valign="top"|POP3||The mail protocol type.  POP3, SMTP and ESMTP are the currently supported protocols.
 
|-
 
|-
 
|valign="top"|<expN1>||valign="top"|No||valign="top"|25||The SMTP/ESMTP port number.
 
|valign="top"|<expN1>||valign="top"|No||valign="top"|25||The SMTP/ESMTP port number.
Line 27: Line 27:
  
 
If successful the MAILOPEN() will return .T., otherwise .F..  The MAILERROR() function can be used to return the error message if the MAILOPEN() fails.
 
If successful the MAILOPEN() will return .T., otherwise .F..  The MAILERROR() function can be used to return the error message if the MAILOPEN() fails.
 
* Support for ESMTP was introduced in Lianja v1.3
 
  
 
==Example==
 
==Example==

Latest revision as of 11:20, 14 January 2020

Purpose

Function to connect to the specified mail server

Syntax

MAILOPEN(<expC1>, <expC2>, <expC3> [, <expC4> [, <expN1>]])

See Also

BASE64_ENCODE(), CLOSEMAIL(), COUNTMAIL(), DELETEMAIL(), MAILATTACH(), MAILCLOSE(), MAILCOUNT(), MAILDELETE(), MAILERROR(), MAILHEADER(), MAILNODENAME(), MAILREAD(), MAILSAVEAS(), MAILSEND(), MAILUSERNAME(), OPENMAIL(), READMAIL(), SENDMAIL()

Description

The MAILOPEN() function is used to connect to the specified mail server. The mail type POP3 should be used for reading mail, and SMTP/ESMTP used for sending mail.

Parameters Required Default Description
<expC1> Yes None The node name or IP address of the mail server
<expC2> Yes None The user name with which to connect to the mail server. For ESMTP, this must be Base64 encoded.
<expC3> Yes None The password for the user name. For ESMTP, this must be Base64 encoded.
<expC4> No POP3 The mail protocol type. POP3, SMTP and ESMTP are the currently supported protocols.
<expN1> No 25 The SMTP/ESMTP port number.

If successful the MAILOPEN() will return .T., otherwise .F.. The MAILERROR() function can be used to return the error message if the MAILOPEN() fails.

Example

// Open POP3 for reading mail
m_open = mailopen("mailserver.company.com", "username", "password", "POP3")
if not m_open
    dialog box mailerror()
else
    // process mail
    mailclose()
endif
 
// Open SMTP for sending
m_open = mailopen("mailserver.company.com","username","password", "SMTP")
if not m_open
    dialog box mailerror()
else
    //process mail
    mailclose()
endif