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

Nachrichtenkopf

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

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: