POP3_DownLoad

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_DownLoad (pop3_ID; numéroMsg; enTêteSeul; nomFichier) Entier

ParamètreTypeDescription
pop3_IDEntier longRéférence d'une connexion POP3
numéroMsgEntier longNuméro du message
enTêteSeulEntier0 = Message entier, 1 = En-tête seul
nomFichierTexteNom de fichier local
Nom de fichier local utilisé
RésultatEntierCode d'erreur

Description

La commande POP3_DownLoad permet de télécharger un message d'un serveur POP3 en local sur disque. Tout message POP3 contenant des fichiers joints ou dont la taille est supérieure à 32 Ko devra être téléchargé avec cette commande. Les fichiers joints peuvent être extraits uniquement à partir d'un message préalablement téléchargé.

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

Le paramètre numéroMsg désigne le numéro du message à récupérer dans la boîte aux lettres. Ce numéro représente la position d'un message dans la liste courante des 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 enTêteSeul vous permet de spécifier si vous souhaitez récupérer la totalité du message ou uniquement les informations des en-têtes.

Le paramètre nomFichier désigne le nom et/ou l'emplacement du fichier dans lequel vous souhaitez enregistrer le message. Cette valeur peut être spécifiée de trois manières :

""= Enregistre le fichier dans le dossier défini par POP3_SetPrefs, avec
le nom "temp1" (si un fichier de ce nom existe déjà, les noms "temp2",
"temp3", etc., sont essayés).
"nomFichier"= Enregistre le fichier dans le dossier défini par POP3_SetPrefs,avec
le nom nomFichier.
"Chemin:nomFichier"= Enregistre le fichier en utilisant le chemin spécifié par nomFichier.

Dans les deux premiers cas, en l'absence de dossier spécifié par POP3_SetPrefs, le message est enregistré dans le dossier de la structure de la base de données (avec 4D monoposte) ou dans le dossier de 4D Client (avec 4D Server).

Après l'exécution de la commande, le nom final du fichier est retourné dans le paramètre nomFichier. Si vous tentez d'appeler POP3_Download avec un nomFichier qui existe déjà dans le dossier de téléchargement, ce nom est incrémenté et le nom réellement enregistré sur disque est retourné.

Référence

POP3_SetPrefs.


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