FP_SMTP_GET_EMAIL_TEXT

发送电子邮件文本

此FP指令读取由nTransferID指定的数字的预定义电子邮件文本，并将文本写入输出变量sBodyText。

参数

输入

nTransferID (WORD, INT, UINT)

设置传输设置ID。

值：0-15

输出

sBodyText (STRING)

存储预定义e-mail 文本

bError (BOOL)

当操作异常结束时，设置为TRUE。

当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

标注

此指令不可用于中断程序。
执行此指令前，需使用FP_SMTP_SET_MODE或SMTP客户端的设置对话框指定电子邮件传输设置。
此指令读取已在SMTP客户端的设置对话框中指定的电子邮件文本。如果未指定电子邮件文本，则它将无法被读取且零将被存储在sBodyText中。
执行此指令前，需使用FP_SMTP_SET_GROUP或SMTP客户端的设置对话框指定组和事件邮件设置。
执行此指令前，检查FP_CLIENT_STATUS_DUT是否有发送电子邮件的活动请求。如果执行指令时bIsTransferRequested为TRUE，则将出现运算错误。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果使用索引寄存器指定的区域超出限制。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。。
如果指定传输设置的电子邮件传输请求标志为“TRUE：请求传输”。
如果指定了未通过指令FP_SMTP_SET_MODE或SMTP客户端的设置对话框配置的电子邮件传输设置。
如果指定了未使用指令FP_SMTP_SET_GROUP或SMTP客户端的设置对话框定义的目标组编号。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果使用索引寄存器指定的区域超出限制。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。。
如果指定传输设置的电子邮件传输请求标志为“TRUE：请求传输”。
如果指定了未通过指令FP_SMTP_SET_MODE或SMTP客户端的设置对话框配置的电子邮件传输设置。
如果指定了未使用指令FP_SMTP_SET_GROUP或SMTP客户端的设置对话框定义的目标组编号。

sys_bIsCarry（对于一次扫描变为TRUE）

如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bRequest: BOOL:=FALSE;
		bError: BOOL:=FALSE;
		iID8: INT:=8;
		sEmailText: STRING[32]:='Hello World!';
	END_VAR

POU本体

如果bRequest从FALSE变为TRUE且sys_bIsEthernetSMTPClientReady设置为TRUE，将执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bRequest,4,1,6,3,R);
B(B_VARIN,,iID8,23,2,25,4,);
B(B_VAROUT,,bError,39,3,41,5,);
B(B_CONTACT,,sys_bIsEthernetSMTPClientReady,15,1,17,3,);
B(B_F,FP_SMTP_GET_EMAIL_TEXT!,,25,0,39,5,,?DEN?DnTransferID?AENO?CsBodyText?CbError);
B(B_VAROUT,,sEmailText,39,2,41,4,);
L(1,2,4,2);
L(6,2,15,2);
L(17,2,25,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If DF(bRequest) AND sys_bIsEthernetSMTPClientReady then
    FP_SMTP_GET_EMAIL_TEXT(nTransferID := iID8,
                           sBodyText => sEmailText,
                           bError => bError);
END_If;