PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • No next email
  • Initializing the reading of emails
  • Using the POP3 protocol
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Reads the incoming email found after the current email:
  • via the POP3 or IMAP protocol: the incoming emails are found in the mailbox.
If no email is found (no next message), the Email.Out variable is set to True.
Reminder: Before reading an email, it is necessary to open a session with EmailStartSession, EmailStartNotesSession or EmailStartOutlookSession.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 22 and later
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
New in version 22
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
// Read the first email
EmailReadFirst(EmailID)
IF Email.Out = False THEN
// Displays the sender and the subject in a table
TableAdd(TABLE_IncomingEmails, Email.Sender + TAB + Email.Subject)
// Read the next email
EmailReadNext(EmailID)
END
Syntax

Reading the next incoming email via the POP3 or IMAP protocol Hide the details

<Result> = EmailReadNext(<Session> [, <Email>])
<Result>: Boolean
  • True if the message was read,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred.
    To get the details of the error, use ErrorInfo with the errMessage constant. If no email is found, ErrorOccurred remains set to False and the Email.Out variable is positioned to True.
<Session>: Character string, or emailPOP3Session or emailIMAPSession variable
Identifies the user session. Corresponds to:
<Email>: Optional Email variable
Versions 15 and later
Name of the Email variable to be initialized with the message content.
If this parameter is not specified, the Email structure is used.
New in version 15
Name of the Email variable to be initialized with the message content.
If this parameter is not specified, the Email structure is used.
Name of the Email variable to be initialized with the message content.
If this parameter is not specified, the Email structure is used.
Remarks

No next email

If no email was found (no next message), the Email.Out variable is set to True. The next call to EmailReadNext will read the first incoming email (equivalent to EmailReadFirst).

Initializing the reading of emails

If the read operation was not initialized by EmailReadFirst, EmailReadNext is used to read the first message.

Using the POP3 protocol

When reading a message, the files attached to this message can be copied to the local disk with EmailSaveAttachment.
Tip: We recommend that you keep the messages and their attachments on the local disk, then delete them from the server. This operation is used to:
  • reduce the size of the mailbox on the server,
  • improve and speed up the communications in POP3 sessions: only the new messages will be read on the server.
Related Examples:
The POP3 Email functions Unit examples (WINDEV): The POP3 Email functions
[ + ] Using the Email functions to manage the POP3 protocol.
This protocol is used to retrieve emails from a server.
WD JavaMail Training (WINDEV): WD JavaMail
[ + ] This example is a Java example used to read and send emails.
Business / UI classification: Business Logic
Component: wd270com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment