4D Doc Center : POP3

4D Internet Commands v14

POP3_SetPrefs


POP3_SetPrefs ( retoursLigne ; dossierMsg ; dossierDocsJoints ) -> Résultat

Paramètre	Type	Description
retoursLigne	Entier	0 = Ne pas retirer les retours à la ligne, 1 = Retirer les retours à la ligne, -1 = Aucune modification
dossierMsg	Texte	Chemin d'accès au dossier des messages ("" = aucune modification)
dossierDocsJoints	Texte	Chemin d'accès du dossier des documents joints ("" = aucune modification)
Résultat	Entier	Code d'erreur

Description

La commande POP3_SetPrefs définit des préférences générales pour toutes les commandes POP3 ultérieures.

Le paramètre retoursLigne vous permet de préciser comment traiter les caractères de retour à la ligne dans les messages enregistrés. La plupart des serveurs POP3 associent un caractère Retour chariot (carriage return) et un caractère Retour à la ligne (line feed) pour indiquer la fin d'une ligne, à la différence des applications Macintosh qui requièrent un simple Retour chariot. Dans ce cas, cette option vous permet de supprimer les caractères Retour à la ligne superflus du texte des messages.

Si vous passez 0 (zéro) les messages récupérés seront conservés dans le format du serveur POP3.
Si vous passez 1, les caractères Retour à la ligne seront supprimés des messages récupérés.
Si vous passez -1, l'option reste telle qu'elle était précédemment définie.

Par défaut, cette option a pour valeur 1, les retours à la ligne rencontrés dans les messages sont automatiquement supprimés.

Le paramètre dossierMsg indique le chemin d'accès local du dossier dans lequel les messages récupérés à l'aide de la commande POP3_Download doivent être enregistrés par défaut.

Note de compatibilité (version 6.8.1) : Les paramètres retoursLigne et dossierMsg étaient précédemment utilisés par les commandes MSG (thème IC Downloaded Mail). Ce n’est désormais plus le cas lorsque la commande MSG_SetPrefs est utilisée.

Le paramètre dossierDocsJoints indique le chemin d'accès local du dossier dans lequel les fichiers joints doivent être enregistrés lorsque la commande MSG_Extract extrait les documents joints du corps du message.

Note de compatibilité (version 6.8.1) : Le paramètre dossierDocsJoints est également présent dans la commande MSG_SetPrefs, par conséquent vous pouvez le fixer à l’aide de l’une de ces deux commandes. L’usage de la commande MSG_SetPrefs est fortement recommandé. Le paramètre de la commande POP3_SetPrefs, conservé pour des raisons de compatibilité, ne sera plus utilisé dans les prochaines versions du plug-in. Ce paramètre est désormais optionnel et son usage est déconseillé. Cette recommandation s’applique également à la commande POP3_GetPrefs.