4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Encrypted


SMTP_Encrypted ( smtp_ID ; msgCrypté {; supprimerOption} ) -> Résultat

Paramètre	Type	Description
smtp_ID	Entier long	Référence du message
msgCrypté	Texte	Type d'encryptage
supprimerOption	Entier	0 = Remplacer sauf si msgCrypté vide, 1 = Remplacer, 2 = Supprimer
Résultat	Entier	Code d'erreur

Description

La commande SMTP_Encrypted permet d'informer les utilisateurs du type d'encryptage utilisé dans le corps du message. Les commandes Internet de 4D ne permettent pas d'encrypter ou de décrypter des messages électroniques. Le cryptage du corps du message relève de la responsabilité du développeur. Si le corps du message est encrypté (avant son affectation via SMTP_Body), il est nécessaire d'utiliser cette commande pour indiquer au logiciel de messagerie le type d'encryptage employé.

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

Le paramètre msgCrypté indique le type d'encryptage utilisé. L'en-tête "Encryptage" est utilisé par le logiciel de messagerie du destinataire pour décrypter le corps du message reçu. Pour plus amples informations sur le formatage, 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 "Encryptage" éventuellement existant :

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