Set_Attribute_Single：设置某个对象的某一属性

功能块描述

此功能块用于设置对象实例的特定属性的内容。

如要使用此功能块，必须在协议管理器下方添加至少一个 EtherNet/IP 设备。请参阅添加设备。

图形表示形式

输入

下表介绍输入变量：

输入	数据类型	注释
i_xExecute	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。输入 Execute 的上升沿可启动功能块。功能块持续执行，且输出 Busy 设置为 TRUE。功能块执行期间 Execute 输入的另一个上升沿将被忽略。 FALSE：在功能块执行期间，如果输入 Execute 设置为 FALSE，则输出 Done 或 Error 设置为 TRUE（针对一个循环）。 TRUE：只要输入 Execute 设置为 TRUE，输出 Done 或 Error 就设置为 TRUE。
i_xAbort	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。 FALSE：执行尚未中止。 TRUE：执行已被另一个功能块所中止。
i_xMsgType	BOOL	FALSE：UCCM TRUE：已连接（3 类）消息
i_adTargetIP	TCP_ADDR	目标的 IP 地址。
i_dwClass	DWORD	目标类。参见如何在设备文档中查找对象信息。如果类不是请求的一部分，则它必须为 0xFFFFFFFF。
i_dwInstance	DWORD	目标实例。参见如何在设备文档中查找对象信息。如果目标是类实例，则它可以为 0。如果实例不是请求的一部分，则它必须为 0xFFFFFFFF。
i_dwAttribute	DWORD	目标属性。参见如何在设备文档中查找对象信息。如果属性不是请求的一部分，则它必须为 0xFFFFFFFF。
i_abyRequestData	ARRAY OF BYTE 0…MAX_EIP_REQUEST_DATA_SIZE	必须发送至目标的数据。如果未使用，则 wDataSize 必须为 0 ⁽¹⁾。
q_wDataSize	WORD	abyRequestData 的实际大小 ¹。
(1) 输入数据缓冲区也必须经过格式化处理。请参阅 ODVA EtherNet/IP 规范第 1 卷中的 Set_Attribute_Single 请求数据。

输出

下表介绍输出变量：

输出	数据类型	注释
q_xDone	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。 FALSE：执行尚未启动，或者已检出错误。 TRUE：无检出错误时执行终止。
q_xBusy	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。 FALSE：功能块不处于正被执行状态。 TRUE：功能块正在执行中。
q_xAborted	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。 FALSE：执行尚未中止。 TRUE：执行已被 Abort 输入所中止。
q_xError	BOOL	值范围：FALSE，TRUE。缺省值: FALSE。 FALSE：功能块的执行正在进行中，尚未检出错误。 TRUE：已在执行功能块时检出错误。
q_byCommError	BYTE	给出与检出错误有关的信息。请参阅 CommunicationErrorCodes：通讯错误代码。
q_dwOperError	DWORD	给出与检出错误有关的信息。请参阅 OperationErrorCodes：操作错误代码。