cniPropagate

传播消息以指定终端对象。如果终端没有被连接器连接到另一个节点,则此消息没有传播,且函数被视为无操作。因此,在传播消息之前不必检查是否已连接终端,除非节点要执行的操作将是不同的(在这种情况下您可以使用 cniIsTerminalAttached 来检查是否连接了终端)。

语法

int cniPropagate(
    int*                returnCode,
    CciTerminal*  terminalObject,
    CciMessage* destinationList,        
    CciMessage* exceptionList,          
  CciMessage* message);

参数

returnCode
来自函数(输出)的返回码。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
接收消息的输出终端的地址(输入)。地址由 cniCreateOutputTerminal 返回。
destinationList
目标地址列出要用消息发送的对象(输入)。

此消息对象由消息代理提供的 Publish/Subscribe 节点使用。

exceptionList
消息异常列表的地址(输入)。
message
要发送的消息对象的地址(输入)。如果正在发送的消息与输入消息相同,则该地址是在 cniEvaluate 实施函数上传递的地址。

返回值

如果成功,返回 CCI_SUCCESS。否则,返回 CCI_FAILURE,且 returnCode 参数表明错误原因。

示例

  if (terminalObject) {
        if (cniIsTerminalAttached(&rc, terminalObject)) {
            if (rc == CCI_SUCCESS) {
                cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as07620_