SMTP_Bcc

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.5


SMTP_Bcc (smtp_ID; copieDiscrète{; supprimerOption}) Entier

ParamètreTypeDescription
smtp_IDEntier longRéférence de message
copieDiscrèteTexteListe d'adresses
supprimerOptionEntier0 = Ajouter, 1 = Remplacer, 2 = Supprimer
RésultatEntierCode 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)

Référence

SMTP_Cc, SMTP_New.


4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant