4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Keywords


SMTP_Keywords ( smtp_ID ; msgMotsClés {; supprimerOption} ) -> Résultat

Paramètre	Type	Description
smtp_ID	Entier long	Référence de message
msgMotsClés	Texte	Liste de mots-clés
supprimerOption	Entier	0 = Remplacer sauf si msgMotsClés vide, 1 = Remplacer, 2 = Supprimer
Résultat	Entier	Code d'erreur

Description

Le commande SMTP_Keywords permet d'insérer des mots-clés dans l'en-tête "Mots-clés" (Keywords) du message désigné par smtp_ID.

smtp_ID est l'identifiant d'un message électronique créé avec la commande SMTP_New.

Le paramètre msgMotsClés contient un ou plusieurs mots-clés, séparés par des virgules. Pour plus d'informations sur le formatage de ce paramètre, veuillez consulter la RFC 822.

Attention : Le texte ne doit pas contenir de retours à la ligne (code ASCII=10). Un retour à la ligne désigne la fin de la section d'en-tête et le début du corps du texte. Les en-têtes suivants risquent alors d'être considérés comme le corps du texte et de ne pas être correctement reconnus par le logiciel du serveur ou du client. Pour plus d'informations sur les zones d'en-tête, veuillez consulter la RFC 822.

Le paramètre optionnel supprimerOption vous permet de préciser s'il faut conserver ou supprimer l'en-tête "Mots-clés" éventuellement existant :

Si vous passez 0 (zéro), le contenu du paramètre msgMotsClés remplace dans la zone d'en-tête tout texte éventuellement présent, sauf si vous passez une chaîne vide dans msgMotsClés, auquel cas l'en-tête "Mots-clés" existant et son contenu sont conservés.
Si vous passez 1, le contenu du paramètre msgMotsClés remplace dans la zone d'en-tête tout texte éventuellement présent. Dans ce cas, si vous passez une chaîne vide dans msgMotsClés, l'en-tête "Mots-clés" existant est supprimé.
Si vous passez 2, l'en-tête "Mots-clés" est supprimé du message.
Si supprimerOption est omis, par défaut la valeur 0 est utilisée.