MAILOPEN()

From Lianjapedia
Jump to: navigation, search

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. Support for ESMTP was introduced in Lianja v1.3.
<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