FB_SmtpV3

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetID;   (* AmsNetID *)
    sSmtpServer : T_MaxString;  (* Smtp Server addres ( IP or Name) *)
    sUsername   : T_MaxString;  (* Smtp Username *)
    sPassword   : T_MaxString;  (* Smtp Password *)
    nEncryption : UDINT;    (* 0=NONE, 1=STARTTLS, 2=SSL *)
    sFrom       : T_MaxString;  (* Sender stzring *)
    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;    (* Messagelength in byte to send *)
    bExecute    : BOOL;
    tTimeout    : TIME := T#20s;
END_VAR

sNetId: AmsNetID on which the TwinCAT Smtp server runs.

sSmtpServer: Name or IP of the Smtp server.

sUsername: Username for the Smtp Server.

sPassword: Password for the Smtp Server.

nEncryption: Smtp encryption type:
0 = NONE
1 = STARTTLS
2 = SSL

sFrom: A string containing the e-mail address of the sender. A sender must be specified. The string is limited to 255 characters.

sTo: A string containing the e-mail address of the recipient. Several addresses can be specified, separated by semicolon. At least one recipient has to be specified. The string is limited to 255 characters.

sCc: A string containing an e-mail address of a further recipient (cc=carbon copy). This string can also be empty. A copy of the e-mail is sent to this recipient. The e-mail address of this recipient is visible to other recipients. It is possible to enter multiple recipient addresses separated by semicolons. The string is limited to 255 characters.

sBcc: A string containing the e-mail address of a further recipient (Bcc = blind carbon copy). This string can also be empty. A copy of the e-mail is sent to this\these recipient\s. The e-mail address of this recipient is not visible to other recipients. It is possible to enter multiple recipient addresses separated by semicolons. The string is limited to 255 characters.

sSubject: A string containing the subject line for the e-mail. The e-mail may be sent without subject, in which case the name of the sending computer is automatically entered in the subject line (e.g. "Mail sent from: CX_00762C"). The string for the subject line is limited to 255 characters.

pMessage: The address (a pointer) to a null-terminated string containing the e-mail text. The e-mail may be sent without body text, in which case the date and time are entered automatically (e.g. "Mail sent at: Thu, 23 Mar 2006 02:31:44 -0800"). The address of the string can be determined with the ADR operator.

cbMessage: Length of the e-mail text. The length can be determined through the LEN operator.

bExecute: The function block is activated by a rising edge at this input

tTimeout: Maximum time allowed for the execution of the command.

VAR_OUTPUT

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

bBusy: the output variable remains TRUE until the function block has executed a command, but only until tTimeOut has expired.

bError : the output variable is switched to TRUE as soon as an error occurs during the execution of the command. The command-specific error is contained in nErrId.

nErrId: contains the command-specific error code of the most recently executed command (see table).

Make sure that you do not use \o within the byte-arrays, otherwise the message will be stopped. The maximum number of characters in a message is 510,725 - in total you have 1275 characters for From, To, Cc, Bcc and Subject.

Requirements