FB_Smtp

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetID;     (* AmsNetID *)
    sSmtpServer     : T_MaxString;    (* Smtp-Server address (IP or Name) *)
    sFrom       : T_MaxString;    (* Sender string *)
    sTo         : T_MaxString;    (* To recipient string *)
    sCc         : T_MaxString;    (* Cc recipient string *)
    sBcc        : T_MaxString;    (* Bcc recipient string *)
    sSubject        : T_MaxString;    (* Subject string *)
    pMessage        : DWORD;         (* Pointer to the message *)
    cbMessage           : UDINT;         (* Messagelenght to send *)
    bExecute        : BOOL;
    tTimeout        : TIME := T#20s;
END_VAR

sNetId: AmsNetID worauf der TwinCAT Mail Servers läuft.

sSmtpServer: Name oder IP des Smtp-Servers.

sFrom: Ein String, der die Emailadresse des Absenders enthält. Es muss ein Absender angegeben werden. Der String ist auf 255 Zeichen begrenzt.

sTo: Ein String, der die Emailadressen der Empfänger beinhaltet. Es können mehrere Adressen angegeben werden, diese müssen dann mit einem Semikolon getrennt werden. Es muss mindestens ein Empfänger angegeben werden. Der String ist auf 255 Zeichen begrenzt.

sCc: Ein String mit einer E-Mail-Adresse eines weiteren Empfängers (Cc=Carbon Copy). Es kann auch ein Leerstring angegeben werden. Eine Kopie der E-Mail wird an diesen Empfänger gesendet. Die E-Mail-Adresse dieses Empfängers wird bei anderen Empfängern sichtbar. Es dürfen auch mehrere Empfängeradressen getrennt durch Semikolons angegeben werden. Der String ist auf 255 Zeichen begrenzt.

sBcc: Ein String mit einer E-Mail-Adresse eines weiteren Empfängers (Bcc=Blind Carbon Copy). Es kann auch ein Leerstring angegeben werden. Eine Kopie der E-Mail wird an diese\n Empfänger gesendet. Die E-Mail-Adresse dieses Empfängers wird bei anderen Empfängern nicht sichtbar. Es dürfen auch mehrere Empfängeradressen getrennt durch Semikolons angegeben werden. Der String ist auf 255 Zeichen begrenzt.

sSubject: Ein String mit dem Betreff der E-Mail. Die E-Mail kann auch ohne Betreff versendet werden. Sie bekommt dann automatisch den Namen vom versendenden Computer in den Betreff eingetragen (z.B. "Mail send from: CX_00762C"). Der String für den Betreff ist auf 255 Zeichen begrenzt.

pMessage: Die Adresse (Pointer) eines nullterminierten Strings mit dem E-Mail-Text. Die E-Mail kann auch ohne Bodytext versendet werden, sie bekommt dann automatisch einen kleinen Satz mit dem Sendedatum und Uhrzeit eingetragen (z.B. "Mail send at: Thu, 23 Mar 2006 02:31:44 -0800"). Die Adresse des Strings kann mit dem ADR-Operator ermittelt werden.

cbMessage: Die Länge des E-Mail-Textes. Die Länge kann durch den LEN-Operator ermittelt werden.

bExecute: Eine steigende Flanke an diesem Eingang aktiviert den Funktionsbaustein.

tTimeout: Maximale Zeit, die bei der Ausführung des Befehls nicht überschritten werden darf.

VAR_OUTPUT

VAR_OUTPUT
    bBusy   : BOOL;
    bError  : BOOL;
    nErrId  : UDINT;
END_VAR

bBusy: Dieser Ausgang bleibt solange auf TRUE, bis der Baustein eine Befehlsanforderung ausführt, längstens aber für die Dauer der an dem tTimeOut-Eingang angelegten Zeit.

bError: Dieser Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung eines Befehls ein Fehler aufgetreten ist. Der befehlsspezifische Fehlercode ist in iErrorId enthalten.

nErrId: Enthält den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls (siehe Tabelle).

Stellen sie sicher, dass Sie innerhalb des byte-Arrays keine \0 Stellen haben, da die Message dort abgebrochen wird. Die maximale Anzahl der Zeichen, die in einer Message verwendet werden dürfen, ist 510.725 - für From, To, Cc, Bcc und Subject stehen 1275 Zeichen zur Verfügung.

Voraussetzungen