Difference between revisions of "MAILOPEN()"
From Lianjapedia
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
| Line 6: | Line 6: | ||
==See Also== | ==See Also== | ||
| − | [[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[READMAIL()]], [[SENDMAIL()]] | + | [[BASE64_ENCODE()]], [[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[READMAIL()]], [[SENDMAIL()]] |
==Description== | ==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 used for sending mail. | + | 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. |
{| class="wikitable" width="100%" | {| class="wikitable" width="100%" | ||
| Line 16: | Line 16: | ||
|<expC1>||Yes||None||The node name or IP address of the mail server | |<expC1>||Yes||None||The node name or IP address of the mail server | ||
|- | |- | ||
| − | |valign="top"|<expC2>||valign="top"|Yes||valign="top"|None||The user name with which to connect to the mail server | + | |valign="top"|<expC2>||valign="top"|Yes||valign="top"|None||The user name with which to connect to the mail server. For ESMTP, this must be [[BASE64_ENCODE()|Base64 encoded]]. |
|- | |- | ||
| − | |<expC3>||Yes||None||The password for the user name | + | |<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 | + | |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 port number. | + | |valign="top"|<expN1>||valign="top"|No||valign="top"|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. | 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== | ||
| Line 34: | Line 36: | ||
if not m_open | if not m_open | ||
dialog box mailerror() | dialog box mailerror() | ||
| − | + | else | |
| − | mailclose() | + | // process mail |
| + | mailclose() | ||
| + | endif | ||
// Open SMTP for sending | // Open SMTP for sending | ||
| Line 41: | Line 45: | ||
if not m_open | if not m_open | ||
dialog box mailerror() | dialog box mailerror() | ||
| − | + | else | |
| − | mailclose() | + | //process mail |
| + | mailclose() | ||
| + | endif | ||
</code> | </code> | ||
Revision as of 08:36, 2 February 2015
Contents
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.
- Support for ESMTP was introduced in Lianja v1.3
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
