ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Managing emails
  • Overview of IMAP protocol
  • Using the IMAP protocol
  • Receiving messages by using the IMAP protocol
  • Remarks
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
Overview of IMAP protocol
The IMAP protocol is a standard protocol for managing emails. Unlike the POP3 protocol, the principle for using the IMAP protocol consists in leaving the messages on the messaging server in order to read them from several clients. It includes a specified indicator used to find out whether a message was read. Several messaging servers support both the IMAP protocol and the POP3 protocol.
Remarks:
Using the IMAP protocol

Receiving messages by using the IMAP protocol

To receive emails by using the IMAP protocol
  1. Start an IMAP session by using an emailIMAPSession variable and EmailStartSession.
    Example for starting a session by using an emailIMAPSession variable:
    // Start the messaging session
    MySession is emailIMAPSession
    MySession.ServerAddress = "pop.mycompany.us"
    MySession.Name = "user"
    MySession.Password = "secret"
    EmailStartSession(MySession)
  2. Read the messages on the messaging server:
    • with the EmailGetAll function.
    • with a loop such as:
      Example that uses an Email variable:
      MyMessage is Email
      EmailReadFirst(MySession,MyMessage)
      WHILE NOT MyMessage.Out
      // Place the process of the message read...
      ...
      EmailReadNext(MySession, MyMessage)
      END

      Example that uses the Email structure:
      EmailReadFirst(MySession)
      WHILE NOT Email.Out
      // Place the process of the message read...
      ...
      EmailReadNext(MySession)
      END
    • or with a loop such as (the "NOT READ" keywords are optional and they allow you to browse only the unread messages or all the messages):
      MyMessage is Email
      FOR EACH MyMessage NOT READ OF MySession
      // Place the process of the message read...
      ...
      END
  3. Close the IMAP session with EmailCloseSession.
Remarks
Related Examples:
WD Mail Complete examples (WINDEV): WD Mail
[ + ] This application is an email client developed in WINDEV. It is based on the Email objects.
This email client is used to retrieve and send emails by using the POP, IMAP and SMTP protocols.
You have the ability to apply filters to the incoming emails.

The application can also be used to manage several email accounts. The writing of an email is based on the HTML edit control.
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help