4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Bcc


SMTP_Bcc ( smtp_ID ; copieDiscrète {; supprimerOption} ) -> Résultat

Paramètre	Type	Description
smtp_ID	Entier long	Référence de message
copieDiscrète	Texte	Liste d'adresses
supprimerOption	Entier	0 = Ajouter, 1 = Remplacer, 2 = Supprimer
Résultat	Entier	Code d'erreur

Description

La commande SMTP_Bcc ajoute des destinataires en "copie discrète" (Blind carbon copy) au message spécifié par smtp_ID. Pour envoyer un message, le champ "Bcc" n'est pas obligatoire.

La seule façon de préserver la confidentialité de la liste d'adresses lors de l'envoi de courrier à un ensemble de personnes est d'insérer ces adresses dans la zone d'en-tête "Bcc". Les adresses listées dans cet en-tête ne sont pas envoyées dans le corps ni dans l'en-tête du message. Ces adresses ne peuvent être lues par aucun destinataire du message.

Un destinataire "Bcc" peut visualiser tous les destinataires "A" et "Cc", mais pas les autres destinataires "Bcc". Généralement, lors d'envoi de courrier en masse, tous les destinataires doivent être placés dans l'en-tête "Bcc". Cela permet d'éviter que les messages reçus soient encombrés par une grande liste d'adresses, et de ne pas communiquer les adresses des destinataires.

Une autre raison de l'utilisation de "Bcc" est que la plupart des messageries électroniques disposent d'une fonction "Répondre à tous". Celle-ci transfère toutes les adresses présentes dans les champs "A" et "Cc" du message reçu dans le champ "A" du message à renvoyer. Placer les adresses dans l'en-tête "Bcc" permet d'éviter qu'un ou plusieurs destinataires répondent à tous les destinataires initiaux.

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

Le paramètre copieDiscrète contient une ou plusieurs adresses.

Le paramètre supprimerOption vous permet de préciser s'il faut conserver ou supprimer la zone d'en-tête "Cc" éventuellement existante :

Si vous passez 0 (zéro), le contenu du paramètre passé est ajouté au contenu de l'en-tête existant.
Si vous passez 1, le contenu du paramètre passé remplace le contenu de l'en-tête existant. Dans ce cas, si vous avez passé une chaîne vide dans copieDiscrète, l'en-tête "Bcc" est supprimé.
Si vous passez 2, l'en-tête "Bcc" est supprimé du message.
Si supprimerOption est omis, par défaut la valeur 0 est utilisée.

Exemple

Dans cet exemple, pour chaque enregistrement de la table [Personnes], une adresse est ajoutée à la liste de copies discrètes :

 $erreur:=SMTP_From($smtp_id;"sales@massmarket.com")

 $erreur:=SMTP_Subject($smtp_id;"Ventes incroyables ! Seulement cette semaine !")

 $erreur:=SMTP_Body($smtp_id;$CorpsGénérique)

 Boucle($i;1;Enregistrements trouves([Personnes]))

    $erreur:=SMTP_Bcc($smtp_id;[Personnes]Email;0) `Ajoute cette adresse e-mail à la liste BCC

    ENREGISTREMENT SUIVANT([Personnes])

 Fin de boucle

 $erreur:=SMTP_Send($smtp_id) `Envoie le message à tout le monde

 $erreur:=SMTP_Clear($smtp_id)