POP3_GetMessage

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.5


POP3_GetMessage (pop3_ID; numéroMsg; décalage; longueur; texteMsg) Entier

ParamètreTypeDescription
pop3_IDEntier longRéférence d'une connexion POP3
numéroMsgEntier longNuméro du message
décalageEntier longCaractère à partir duquel commencer la
récupération
longueurEntier longNombre de caractères à renvoyer
texteMsgTexteTexte du message
RésultatEntierCode d'erreur

Description

La commande POP3_GetMessage retourne le contenu du message désigné par numéroMsg dans la boîte aux lettres référencée par pop3_ID. Sauf spécification contraire de la commande POP3_SetPrefs, les caractères Retour à la ligne (Line feed) à l'intérieur du message sont supprimés. La commande POP3_GetMessage renvoie l'intégralité du message, y compris les informations des zones d'en-tête.

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

Le paramètre numéroMsg désigne le message à récupérer dans la boîte aux lettres. Le numéroMsg représente la position du message dans la liste courante de messages. Attention, le numéroMsg d'un message n'est pas une valeur stable, il diffère d'une session à l'autre en fonction des suppressions effectuées.

Le paramètre décalage vous permet d'indiquer la position du caractère (calculée par rapport au début du message) à partir duquel commencer la lecture. Dans la plupart des cas, vous passerez 0 (zéro) dans ce paramètre.

Le paramètre longueur indique le nombre de caractères à récupérer au-delà de la position de décalage. La longueur maximale d'une variable 4D de type Texte étant limitée à 32 000 caractères, le paramètre longueur doit être inférieur à 32 000. Les messages dont la taille est supérieure doivent être récupérés sur disque au moyen de la commande POP3_Download.

Le texte récupéré est retourné dans la variable texteMsg.

Référence

POP3_DownLoad, POP3_SetPrefs.


4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant