Verschickt eine E-Mail. Der E-Mail-Versand muss in Syslog-PPS entsprechend konfiguriert sein (siehe email.ini).
Prototype
SY_MailSendEx( from, to, cc, bcc, subject, body, attachment )
Parameter
Parameter
Typ
Bedeutung
from
string
E-Mail-Adresse des Absenders. Optional kann dahinter noch der Name des Absenders folgen, welcher dann durch das Pipe-Symbol (Verkettungszeichen, '|') von der E-Mail-Adresse getrennt werden muss. Wenn ein leerer String ("") übergeben wird, dann werden die entsprechenden Werte aus MAILSEND_SENDER und MAILSEND_NAME aus der email.ini gezogen.
to
string
E-Mail-Adresse des Empfängers
cc
string
E-Mail-Adresse, an die eine Kopie geschickt werden soll (CC-Adresse; kann auch leer gelassen werden)
bcc
string
E-Mail-Adresse, an die eine Blindkopie geschickt werden soll (BCC-Adresse; kann auch leer gelassen werden)
subject
string
Betreff
body
string
Eigentlicher Inhalt der E-Mail
attachment
string/table
Anhang / Anhänge. Entweder ein string, der den vollständigen Pfad der anzuhängenden Datei enthält oder ein Lua-Table, der strings mit Pfaden zu anzuhängenden Dateien enthält. Kann auch leer gelassen werden ("").
Rückgabewert
Nummer
Typ
Bedeutung
1
number
0 (Aufruf erfolgreich) oder < 0 im Fehlerfall
Hinweise
Der E-Mail-Versand kann nur funktionieren, wenn er in Syslog-PPS entsprechend eingerichtet ist (siehe Konfiguration_Syslog-EMAIL und email.ini)
Rückgabewert auf Fehler prüfen!
Beispiel
--[[
E-Mail versenden
--]]
local res = SY_MailSendEx( "mustermann@example.com|Max Mustermann", -- FROM (Absender)
"musterfrau@example.com", -- TO (Empfänger)
"", -- CC (Kopie)
"", -- BCC (Blindkopie)
"Test-Mail aus LUA", -- Betreff
"Dies ist der Inhalt der E-Mail. Viel steht hier nicht drin...", -- Inhalt
"" ) -- Anhang/Anhänge
if res ~= 0 then
SY_Proto( "SY_MailSendEx hat folgenden Fehler produziert: " .. res )
else
SY_Proto( "E-Mail erfolgreich versandt" )
end