OPENMAIL()

Purpose

Function to connect to the specified mail server

Syntax

OPENMAIL(<expC1> [, <expC2>, <expC3> , <expC4>])

See Also

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

Description

The OPENMAIL() 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.

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
<expC3>	Yes	None	The password for the user name
<expC4>	No	SMTP	The mail protocol type. POP3 and SMTP are the currently supported protocols.

If successful the OPENMAIL() function 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 = openmail("mailserver.company.com", "username", "password", "POP3")
if not m_open
    dialog box mailerror()
endif
closemail()
 
// Open SMTP for sending
m_open = mailopen("mailserver.company.com")
if not m_open
    dialog box mailerror()
endif
closemail()

Products

Recital, Recital Server