参数 数据类型 说明 InterfaceIdLADDR 以太网接口的硬件标识符 ID CONN_OUC 连接 ID ConnectionType BYTE 连接类型。选择16#21 作为 IPv6 的连 接类型。 ActiveEstablishment BOOL 建立主动/被动连接。由于 CP 通常作为SMTP 客户端，需将该参数置位为 “1”。 WatchDogTime TIME 运行看门狗程序。该参数用于定义发送操作的Zui大执行时间。 注：如果连接速度较慢，则连接的建立 时间可能比较长（约 1 分钟）。指定参 数 WatchDogTime时，必须为连接的建 立预留足够的时间。 超出指定的时间后，连接将立即终止。 MailServerAddress IP_V6邮件服务器的 IP 地址（IPv6 格式）： （十六进制）。该地址分 为 8 个部分，每个部分 2 个字节（共16 个字节）。 示例： UserName STRING[254] 用户名。访问电子邮箱收件箱时，需通过该信息 验证身份，是电子邮件收件箱中邮件的 发送方。 PassWord STRING[254] 用户密码。访问电子邮箱收件箱时，需通过该信息 验证身份，是电子邮件收件箱中邮件的 发送方。 From EMAIL_ADDR电子邮件的发件方地址，由以下两个 STRING 参数定义。例如， ”。 LocalPartPlusAtSign STRING[64]发件方地址的本地部分，包括 @ 符号。 示例： ”参数 数据类型 说明 FullQualifiedDomainNameSTRING[254] 邮件服务器的 Fully Qualified Domain Name（缩写为 FQDN）。如，“mymailserver.com” RemotePort UINT 电子邮件服务器的 TCP 端口ActivateSecureConn BOOL • 1：SMTP 安全连接 • 0：SMTP 连接（非安全连接）。此时，以下参数不相关。 ExtTLSCapabilities BYTE 当前未使用 TLSServerCertRef UDINT对电子邮件服务器中 X.509 V3 (CA) 证 书的引用，用于 TLS 客户端对 TLS 服务 器进行认证。
TMail_QDN_SEC：通过 FQDN寻址邮件服务器 参数 数据类型 说明 TMail_QDN_SEC Struct InterfaceId LADDR以太网接口的硬件标识符 ID CONN_OUC 连接 ID ConnectionType BYTE 连接类型。选择 16#22 作为FQDN 的连 接类型。 ActiveEstablishment BOOL 建立主动/被动连接。由于 S7-CP 通常为 SMTP客户端，该参数需置位为“1”。 WatchDogTime TIME 运行看门狗程序。该参数用于定义发送 操作的Zui大执行时间。注：如果连接速度较慢，则连接的建立 时间可能比较长（约 1 分钟）。指定参 数 WatchDogTime 时，必须为连接的建立预留足够的时间。 超出指定的时间后，连接将立即终止。 MailServerQDN STRING[254] 邮件服务器的 FQDN(Fully Qualified Domain Name)。使用全限定域名对邮 件服务器进行寻址，域名必需以“.”结尾。示例 UserName STRING[254] 用户名 访问电子邮箱收件箱时，需通过该信息验证身份，是电子邮件收件箱中邮件的 发送方。 PassWord STRING[254] 用户密码 访问电子邮箱收件箱时，需通过该信息验证身份，是电子邮件收件箱中邮件的 发送方。 From EMAIL_ADDR 电子邮件的发件方地址，由以下两个 STRING参数定义。例如， LocalPartPlusAtSign STRING[64] 发件方地址的本地部分，包括 @ 符号。示例：参数 数据类型 说明 FullQualifiedDomainName STRING[254] 邮件服务器的 FullyQualified Domain Name（缩写为 FQDN）。如， “mymailserver.com” RemotePortUINT 电子邮件服务器的 TCP 端口 ActivateSecureConn BOOL • 1：SMTP 安全连接 • 0：SMTP非安全连接。此时，以下 参数不相关。 ExtTLSCapabilities BYTE 当前未使用 TLSServerCertRefUDINT 对电子邮件服务器中 X.509 V3 (CA) 证 书的引用，用于 TLS 客户端对 TLS 服务 器进行认证。参数DONE、BUSY 和 ERROR (S7-1200, S7-1500) 说明 如果输出参数 BUSY的状态由“1”变为“0”，则输出参数 DONE、BUSY 和 ERROR 各分别显示一 个循环。 下表列出了 DONE、BUSY 和ERROR 之间的关系。 使用该表，可以确定指令“TMAIL_C”的当 前状态，以及电子邮件发送完成的时间。 DONE BUSYERRO R 说明 0 1 0 作业正在处理。 1 0 0 作业已成功完成。 0 0 1 由于出错，导致作业结束。错误的原因可以从STATUS (页 5579) 参数中找到。 0 0 0 没有为“TMAIL_C”指令分配（新）作业。STATUS 参数(S7-1200, S7-1500) 说明 下表列出了 STATUS 参数处“TMAIL_C”的返回值： 返回值 STATUS*（W#16#... ）： 说明 备注 0000 “TMAIL_C”已成功执行完毕。 “TMAIL_C”无错完成并不表示发送的电子邮件一定能到达目的地。 收件人地址输入错误并不会导致指令 “TMAIL_C”生成状态错误。这种情况下，不能保证电子邮件能发送至其它收件人， 这些收件人地址正确无误。 7001 “TMAIL_C”激活 (BUSY = 1)。首次调用：作业已启动。 7002 “TMAIL_C”激活 (BUSY = 1)。 中间调用：作业已激活。 80xx“TMAIL_C”的处理已完成，且存在 一个内部调用通信指令的错误代 码。 相关详细信息，请参见“TCON(页 5606)”、“TDISCON (页 5615)”、 “TSEND(页5621)”和“TRCV(页5625)”通 信指令的 STATUS 参数说明。 8010 连接建立期间出错 可在背景数据块的 SFB_STATUS 参数中找到有关评估的详细信息。参数 SFB_STATUS 中显示的错误代码将在 “TCON(页5606)”指令的 STATUS 参数说明中进行解释。 8011 发送数据时出错 可在背景数据块的 SFB_STATUS 参数中 找到有关评估的详细信息。参数SFB_STATUS 中显示的错误代码将在 “TSEND (页 5621)”指令的 STATUS 参数说 明中进行解释。8012 接收数据时出错 可在背景数据块的 SFB_STATUS 参数中 找到有关评估的详细信息。参数 SFB_STATUS中显示的错误代码将在 “TRCV (页 5625)”指令的 STATUS 参数说明 中进行解释。返回值 STATUS*（W#16#... ）： 说明 备注 8013 连接建立期间出错 可在背景数据块的 SFB_STATUS 参数中找到有关评估的详细信息。参数 SFB_STATUS 中显示的错误代码将在 “TCON (页 5606)”和“TDISCON(页 5615)”指令的 STATUS 参数说明中进行 解释。 8014 无法建立连接。 可能输入了错误的邮件服务器 IP 地址(MailServerAddress (页 5566)) 或由于持 续时间太短 (WatchDogTime (页5566))而 无法建立连接。也有可能是因为 CPU 没有 网络连接，或者 CPU 组态不正确。 8015 MAIL_ADDR_PARAM的数据类型 不正确 有效的数据类型只有 TMail_V4、 TMail_V6 和 TMail_FQDN 系统数据类型 （结构）。自指令版本 V4.0 起，以下系统时间类型也 有效：TMail_V4_SEC、TMail_V6_SEC 和 TMail_QDN_SEC8016 ATTACHMENT 参数的数据类型不 正确 有效的数据类型只有 ArrayOfByte、 ArrayOfWord 和ArrayOfDWord。 8017 ATTACHMENT 参数的数据长度不 正确 数据长度必须 <= 65534 个字节。82xx** 邮件服务器生成的错误消息，且与 SMTP 协议的错误编号相对应（“8” 除外）。 STATUS是一个十六进制值，Zui后三位数字 与邮件服务器或 SMTP 协议的十进制错误 编号相对应。 有关 SMTP 错误代码和 SMTP协议中其它 错误代码的更多详细信息，请访问 Internet 或参见邮件服务器的错误信息文 档。 如果指令版本 <V5.0，以下规则适用：邮 件服务器的Zui新错误消息也可在 BUFFER 1 参数的背景数据块中查看。“TMAIL_C”指令Zui近发送的数据位于该背景数据块的 DATA 中。