4D Doc Center : POP3

4D Internet Commands v14

POP3_UIDToNum


POP3_UIDToNum ( pop3_ID ; uniqueID ; numéroMsg ) -> Résultat

Paramètre	Type	Description
pop3_ID	Entier long	Référence à une connexion POP3
uniqueID	Chaîne	ID unique d'un message sur le serveur
numéroMsg	Entier long	Numéro du message
Résultat	Entier	Code d'erreur

Description

La commande POP3_UIDToNum retourne le numéro de message numéroMsg correspondant au message désigné par uniqueID dans la boîte aux lettres référencée par pop3_ID.
Le numéroMsg d'un message étant une valeur fluctuante, relative aux autres messages de la liste, cette commande renvoie la position courante d'un message dont les informations peuvent avoir été récupérées à l'occasion d'une précédente session POP3.

pop3_ID contient la référence d'une session ouverte avec POP3_Login.

Le paramètre uniqueID contient l'ID unique du message à localiser sur le serveur POP3. La commande recherche cette valeur dans les en-têtes des messages référencés dans la session identifiée par pop3_ID. Une fois trouvé, le numéro du message est retourné dans numéroMsg.

Le paramètre numéroMsg retourne le numéro courant du message désigné par uniqueID. Si l'uniqueID ne peut pas être trouvé sur le serveur, numéroMsg retourne 0 (zéro), aucune erreur n'est renvoyée.