ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Managing emails
  • Deleted messages (POP3 protocol)
  • New messages (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
Returns the number of incoming messages on the email server (POP3 protocol).
This number of messages remains constant during the entire email session, even if new emails are received or if emails are deleted by EmailDeleteMessage.
Example
MySession is emailPOP3Session
 
nbMSG is int = MySession.NbMessage()
FOR I = 1 TO nbMSG
EmailReadMessage(MySession, I)
IF Email.Out <> True THEN
CU.NAME = Email.Sender
CU.MESSAGE_TXT = Email.Message
...
ELSE
Info("This message was deleted")
END
END
Syntax
<Result> = <POP3 session>.NbMessage()
<Result>: Integer
  • Number of messages received on the server at the beginning of current email session,
  • -1 if an error occurred. To get more details on the error, use ErrorInfo.
<POP3 session>: emailPOP3Session variable
Name of the emailPOP3Session variable corresponding to the email session to use.
Remarks

Deleted messages (POP3 protocol)

If a message was deleted by EmailDeleteMessage:
  • <emailPOP3Session variable>.NbMessage returns the number of messages on the email server before they are deleted.
  • the message numbers are not re-assigned.
Therefore, if four messages are found on the server at the beginning of session, these messages are numbered from 1 to 4. If message #1 is deleted:
  • <emailPOP3Session variable>.NbMessage used in the same session always returns 4.
  • Message 1 cannot be read by EmailReadMessage because the message does not exist anymore (only messages 2, 3 and 4 exist).
The message numbers are re-assigned during the next connection.

New messages (POP3 protocol)

The POP3 protocol cannot be used to find out and manage the new messages received during the connection. To get the new messages, you must disconnect (<emailPOP3Session variable>.CloseSession) and reconnect (<emailPOP3Session variable>.StartSession).
Component: wd290com.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help