Zum Hauptinhalt springen
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

MailData - Nachrichtenkopf

obj -> MailData(int1, alpha2[, alpha3[, alpha4]]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

E-Mail definieren - Nachrichtenkopf

Details

Nachrichtenkopf

Für den Nachrichtenkopf stehen folgende Konstanten zur Verfügung:

  • int1: alpha2 alpha3 alpha4
  • _SmtpFrom: Mailadresse des Absenders Name des Absenders DSN: RET / ENVID
  • _SmtpTo: Mailadresse des Empfängers Name des Empfängers DSN: NOTIFY / ORCPT
  • _SmtpCC: Mailadresse des sichtbaren Kopie-Empfängers Name des sichtbaren Kopie-Empfängers DSN: NOTIFY / ORCPT
  • _SmtpBCC: Mailadresse des unsichtbaren Kopie-Empfängers Name des unsichtbaren Kopie-Empfängers DSN: NOTIFY / ORCPT
  • _SmtpSubject: Betreff der Nachricht - -
  • _SmtpReplyTo: Antwort Mailadresse Name des Absenders -
  • _SmtpNotifyTo: Empfangsbestätigungs-Adresse Name des Empfängers der Empfangsbestätigung -
  • _SmtpXtension: Name des nicht standardisierten Headereintrags Wert des Eintrags -
  • _SmtpPriority: Priorität der Nachricht - -
info

Wird als Nachrichteninhalt eine EML-Datei (siehe _MailFileEML ) angegeben, müssen die Optionen _SmtpFrom und _SmtpTo angegeben werden. Weiterhin können können ausschließlich die Optionen _SmtpCC und _SmtpBCC gesetzt werden. Der restliche Nachrichtenkopf kann nicht verändert werden.

Für Nachrichten sind fünf Prioritätsstufen (1 / höchste Priorität bis 5 / niedrigste Priorität) definiert. Der Standardwert ist 3.

Der Nachrichtenkopf muss mindestens den Absender und einen Empfänger der Nachricht beinhalten. Als Empfänger und als Kopie-Empfänger können jeweils mehrere Empfänger eingetragen werden. Die jeweiligen Anweisungen werden dazu mehrfach aufgerufen. Die maximale Anzahl von Adressen ist auf eine Länge von 1024 Zeichen pro Adressart beschränkt, Serienmailings sollten daher für jeden Empfänger eine einzelne Nachricht erzeugen. Um einer Adressart mehrere Adressen zuzuordnen, wird der Befehl MailData() mehrfach hintereinander aufgerufen.

Bei Adressangaben wird in (alpha1) die E-Mail-Adresse und in (alpha2) der Empfängername (optional) übergeben. Es ist zu beachten, dass E-Mail-Adressen außer Buchstaben und Ziffern lediglich die Zeichen '@', '.', '-' und '_' enthalten sollten. Einige andere Zeichen sind zwar auch möglich, können aber nicht von allen Mail-Gateways richtig verarbeitet werden. Keinesfalls zulässig sind Leerzeichen! Der Empfängername kann dagegen beliebige Zeichen (außer Steuerzeichen) enthalten.

Bei den Absender- und Empfängeradressen können in (alpha4) die angegebenen "Delivery Status Notification"-Kommandos (DSN) verwendet werden. Diese sind nach RFC (Request for Comments) 3461 definiert. Ist ein DSN-Kommando definiert, werden vom Mailserver Informationen zum Versandstatus übermittelt. Dies können folgende Status sein: erfolgreich, fehlgeschlagen oder verzögert versendet.

info

Nicht jeder Mailserver unterstützt DSN-Kommandos. Wenn der Mailserver, die DSN-Kommandos nicht unterstützt, wird die E-Mail ohne DSN versendet.

Beispiel:

tHdlMail # MailOpen(_MailSmtp, 'mail.vectorsoft.de');
tHdlMail->MailData(_SmtpFrom, 'support@vectorsoft.de', 'Andreas Schramm');
tHdlMail->MailData(_SmtpTo, 'p.bauer@xyz.com', 'Peter Bauer');
tHdlMail->MailData(_SmtpTo, 'r.schneider@xyz.com', 'Ralf Schneider');
tHdlMail->MailData(_SmtpBCC, 'orga@vectorsoft.de');
tHdlMail->MailData(_SmtpBCC, 'mailarchive@local');
tHdlMail->MailData(_SmtpSubject, 'Bestätigung der Bestellung vom 13.10.2009');
tHdlMail->MailData(_SmtpPriority, '1');

Weitere Informationen finden Sie unter:

Der Befehl gibt folgende Fehlerwerte zurück:

  • Fehlerwert: Bedeutung
  • 0: ok, kein Fehler
  • 13: Datentyp unzulässig
  • 14: Datei nicht vorhanden
  • 16: Format unzulässig
  • 19: interner Fehler

Mögliche Laufzeitfehler: