4D Doc Center : MSG

4D Internet Commands v14

MSG_FindHeader


MSG_FindHeader ( nomFichier ; libelléEnTête ; valeurEnTête ) -> Résultat

Paramètre	Type	Description
nomFichier	Texte	Nom de fichier
libelléEnTête	Chaîne	Libellé de l'en-tête ("From:", "To:", "Subject:", etc.)
valeurEnTête	Texte	Valeur
Résultat	Entier	Code d'erreur

Description

La commande MSG_FindHeader recherche le libelléEnTête dans la section d'en-tête de nomFichier et retourne la valeur du champ dans valeurEnTête. nomFichier contient le nom et/ou le chemin d'accès d'un message téléchargé localement par la commande POP3_DownLoad ou IMAP_Download.

nomFichier désigne le nom ou le chemin d'accès complet du fichier duquel extraire la valeur d'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).

Note de compatibilité (version 6.8.1) : Si la commande MSG_SetPrefs n’est pas utilisée, le paramètre dossierMsg éventuellement défini par la commande POP3_SetPrefs est pris en compte. Si la commande MSG_SetPrefs est utilisée, le paramètre défini par la commande POP3_SetPrefs est ignoré.

Passez dans libelléEnTête une chaîne de caractères contenant le libellé d'en-tête à rechercher. libelléEnTête peut faire référence à tout en-tête défini, spécifié par l'utilisateur ou étendu, tel que "From:" (Emetteur), "To:" (Destinataire), "X-MonEnTête", etc.

Note : Les libellés des en-têtes sont toujours exprimés en anglais.

Le paramètre valeurEnTête reçoit la valeur affectée à la zone d'en-tête spécifiée. Ce paramètre étant susceptible de contenir des caractères étendus, vous pouvez automatiser la gestion de ceux-ci à l’aide de la commande POP3_Charset ou MSG_Charset.

Note de compatibilité (version 6.8.1) : Si la commande MSG_Charset n’est pas utilisée, le paramètre jeuCorps éventuellement défini par la commande POP3_Charset est pris en compte. Si la commande MSG_Charset est utilisée, le paramètre défini par la commande POP3_Charset est ignoré.