- Number of messages found in the mailbox (POP3 protocol)
- Number of messages found in the mailbox (Outlook messaging)
- Outlook messaging
EmailReadMessageHeader (Function) In french: EmailLitEntêteMessage Reads the header of an email received: - via the POP3 or IMAP protocol: the email is found in the in-box on the messaging server.
  via the Lotus Notes or Outlook messaging software: the incoming email is found on the local computer in the in-box of Lotus Notes or Outlook.
The variables of email structure corresponding to the message header are filled. This function is useful when reading the email is linked to the message size for example. The Email.Out variable is set to True if no email is found.
// Use the POP3 protocol
// Read the emails whose size does not exceed MaxEmailSize
I is int
FOR I = 1 TO EmailNbMessage(UserName)
IF EmailMessageLength(UserName, I) < MaxEmailSize THEN
// Procedure for reading and processing the message
ReadMessage()
ELSE
EmailReadMessageHeader(UserName, I)
// Response procedure indicating that the email was not read
ReturnMessage(Email.SenderAddress)
END
END
Syntax
Reading the header of an email managed by the POP3 or IMAP protocol Hide the details
<Result> = EmailReadMessageHeader(<Session> [, <Email>] , <Message number>)
<Result>: Boolean - True if the message header was read. In this case, the email structure is automatically updated.
- False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.
The Email.Out variable is positioned to True if no message was found (no email).
<Session>: Character string, or emailPOP3Session or emailIMAPSession variable Identifies the user session. Corresponds to: <Email>: Optional Email variable Name of the Email variable to be initialized with the message content.
If this parameter is not specified, the Email structure is used. <Message number>: Integer Number of the message whose header will be read. Remarks Number of messages found in the mailbox (POP3 protocol) You can get the total number of messages received with EmailNbMessage. - EmailNbMessage returns the number of messages found on the email server before the deletion.
- the numbers of the deleted messages are not re-assigned.
For example: During the connection, four messages are found on the server and these messages are numbered 1 to 4. If message #1 is deleted: - EmailNbMessage returns 4.
- EmailReadMessage or EmailReadMessageHeader cannot read message # 1: the message no longer exists. The Email.Out variable returns True. Only the messages 2, 3, and 4 exist.
The message numbers are re-assigned during the next connection.
This page is also available for…
|
|
|
|