cniIsTerminalAttached

检查终端是否通过连接符附加到另一个节点。它返回整数值,指定是否指定的终端对象连接到在其他消息流节点上的一个或多个终端。您可以使用它来测试消息是否可以传播到终端。然而,不必在传播附带 cniPropagate 实用程序函数的消息前调用此函数。使用 cniIsTerminalAttached 函数,节点可以在未连接终端时修改其行为。

语法

int cniIsTerminalAttached(
  int*                returnCode,
  CciTerminal*  terminalObject);

参数

returnCode
来自函数(输出)的返回码。可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
terminalObject
要为连接的连接符检查的输入或输出终端的地址(输入)。从 cniCreateOutputTerminal 返回该地址。

返回值

  • 如果终端通过连接符连接到另一个节点,则返回值 1。
  • 如果终端未连接,或发生故障,则返回值零。
  • 如果发生故障,则 returnCode 参数的值表明错误的原因。

示例

if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
      retvalue = cniPropagate(
                                                   &rc,
                             terminalObject, 
                             destinationList, 
                             exceptionList, 
                                message);
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
as07550_