4D Doc Center : POP3

Home

4D Internet Commands v14

POP3_MsgInfo


POP3_MsgInfo ( pop3_ID ; msgNumber ; msgSize ; uniqueID ) -> Function result

Parameter	Type	Description
pop3_ID	Longint	Reference to a POP3 login
msgNumber	Longint	Message number
msgSize	Longint	Message size
uniqueID	String	Unique ID of message on server
Function result	Integer	Error Code

Description

The POP3_MsgInfo command returns information about the message identified by msgNumber within the open mailbox referenced by pop3_ID. Information about the size of the message and its Unique ID will be returned.

pop3_ID is a long integer reference to an open session created with POP3_Login.

msgNumber is a long integer value indicating which message in the mailbox you wish to retrieve information about. The msgNumber represents the position of a message within the current list of messages. You cannot rely on the msgNumber remaining the same for a specific e-mail item from session to session.

msgSize is the long integer value returned containing the size of the message referenced by msgNumber.

uniqueID is a string variable denoting the Unique ID of the message on the server. The uniqueID is a value assigned to the message by the POP3 server software. This value will not change from session to session in the same way as msgNumber. The uniqueID value is a good reference to verify if your database has already downloaded a message from the server.