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/05/19
as07620_