Command POP3_UIDToNum

4D Internet Commands

POP3_UIDToNum

version 6.5


POP3_UIDToNum (pop3_ID; uniqueID; msgNumber) Integer

ParameterTypeDescription
pop3_IDLongintReference to a POP3 login
uniqueIDStringUnique ID of message on server
msgNumberLongintMessage number

Function result Integer Error Code

Description

The POP3_UIDToNum command converts a message's Unique ID value to its current msgNumber within the list of messages in the mailbox referenced by pop3_ID. Since a specific mail message's msgNumber is a floating value relative to other items in the mail list, this command returns the current position of a message whose information may have been retrieved during a prior POP3 session.

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

uniqueID is a string value containing the Unique-ID of a message to locate on the POP3 server. This command will look for this value in the message headers of the account referenced by pop3_ID. Once found, the message's current position in the listing will be returned in msgNumber.

msgNumber is a long integer returned containing the current message number (its position within the current message list) of the item identified by uniqueID. If the uniqueID cannot be found on the server, a zero is returned in msgNumber and no error is returned.