4D Doc Center : MSG

4D Internet Commands v14

MSG_GetHeaders


MSG_GetHeaders ( nomFichier ; décalage ; longueur ; texteEnTête ) -> Résultat

Paramètre	Type	Description
nomFichier	Texte	Nom de fichier
décalage	Entier long	Début du décalage dans la section d'en-têtes (0 = début de l'en-tête)
longueur	Entier long	Nombre de caractères
texteEnTête	Texte	Texte de la section d'en-têtes (supprime les retours à la ligne si Prefs ON)
Résultat	Entier	Code d'erreur

Description

La commande MSG_GetHeaders renvoie sous forme de texte brut la section d'en-têtes du message désigné par nomFichier. L'en-tête d'un message POP3 comprend tout le texte situé à partir du début du message, jusqu'à la première occurrence de deux séquences consécutives de retour chariot/retour ligne (carriage return/line feed).

nomFichier désigne le nom ou le chemin d'accès complet du fichier duquel extraire l'en-tête. Si vous passez un nom de fichier seul, le chemin d'accès par défaut sera celui du dossier défini par POP3_SetPrefs ou MSG_SetPrefs (voir Note de compatibilité). En l'absence de dossier spécifié, le chemin par défaut sera celui du dossier contenant le fichier de structure de la base de données (avec 4D monoposte) ou du dossier de 4D Client (avec 4D Server).

Le paramètre décalage vous permet de définir, dans la section d'en-tête source, la position du caractère à partir duquel commencer la récupération.

Le paramètre longueur définit le nombre de caractères à renvoyer. La longueur de la section d'en-têtes peut être récupérée via MSG_MessageSize.

Le paramètre texteEnTête retourne le texte brut de l'en-tête. Ce paramètre tient compte de la valeur du paramètre retoursLigne éventuellement défini par POP3_SetPrefs ou MSG_SetPrefs.

Note de compatibilité (version 6.8.1) : Si la commande MSG_SetPrefs n’est pas utilisée, les paramètres dossierMsg et retoursLigne éventuellement définis par la commande POP3_SetPrefs sont pris en compte. Si la commande MSG_SetPrefs est utilisée, les paramètres définis par la commande POP3_SetPrefs sont ignorés.