实用程序函数返回码与值

按约定,所有实用程序函数的返回码输出参数被设置为表明成功完成或未成功完成。下表列出了所有返回码及其含义。这些返回码是在 BipCci.h 头文件中定义的。

表 1. 实用程序函数返回码与值
返回码 说明
CCI_BUFFER_TOO_SMALL 输出缓冲区的大小不足以存储请求的数据。
CCI_EXCEPTION 发生异常。
CCI_EXCEPTION_CONFIGURATION 检测到配置异常时调用此函数。1
CCI_EXCEPTION_CONVERSION 检测到转换异常时调用此函数。1
CCI_EXCEPTION_DATABASE 检测到数据库异常时调用此函数。
CCI_EXCEPTION_FATAL 检测到致命异常时调用此函数。1
CCI_EXCEPTION_PARSER 检测到解析器异常时调用此函数。1
CCI_EXCEPTION_RECOVERABLE 检测到可恢复的异常时调用此函数。1
CCI_EXCEPTION_UNKNOWN 指定或遇到了未知异常。
CCI_EXCEPTION_USER 检测到用户异常时调用此函数。1
CCI_FAILURE 函数失败。
CCI_FAILURE_CONTINUE cniRun() 返回值:回滚消息处理并继续执行线程
CCI_FAILURE_RETURN cniRun() 返回值:回滚消息处理并将线程返回到池
CCI_INV_CODEPAGE 指定了无效的代码页编号。
CCI_INV_CHARACTER 检测到缓冲区中要进行转换的无效字符。
CCI_INV_DATA_BUFLEN 指定了零长度的数据缓冲区。
CCI_INV_DATA_POINTER 为输出数据区的地址指定了空指针。
CCI_INV_ELEMENT_OBJECT 为元素对象指定了空指针。
CCI_INV_FACTORY_NAME 指定了无效(空白)的工厂名。
CCI_INV_FACTORY_OBJECT 为工厂对象指定了空指针。
CCI_INV_IMPL_FUNCTION 指定了条件实施函数的无效组合。
CCI_INV_LENGTH 指定了零长度。
CCI_INV_LOG_TYPE 指定的日志类型无效。
CCI_INV_MESSAGE_CONTEXT 为消息上下文指定了空指针。
CCI_INV_MESSAGE_OBJECT 为消息对象指定了空指针。
CCI_INV_NODE_ENV 试图从非输入节点分派线程。
CCI_INV_NODE_NAME 指定了无效(空白)的节点名。
CCI_INV_NODE_OBJECT 为节点对象指定了空指针。
CCI_INV_OBJECT_NAME 对象名中所指定的字符无效。
CCI_INV_PARSER_NAME 指定了无效(空白)的解析器类名。
CCI_INV_PARSER_OBJECT 为解析器对象指定了空指针。
CCI_INV_SQL_EXPR_OBJECT 为 SQL 表达式值指定了空指针。
CCI_INV_STATEMENT 未指定语句。
CCI_INV_TERMINAL_NAME 指定了无效(空白)的终端名。
CCI_INV_TERMINAL_OBJECT 为终端对象指定了空指针。
CCI_INV_TRANSACTION_TYPE 为事务类型指定了无效值。
CCI_INV_VFTP 为用户定义的扩展虚函数指针表的地址指定了空指针。
CCI_MISSING_IMPL_FUNCTION 函数指针表中未定义必要的实施函数。
CCI_NAME_EXISTS 具有相同类名的解析器已存在。
CCI_NO_BUFFER_EXISTS 用于指定的解析器对象的缓冲区不存在。
CCI_NO_EXCEPTION_EXISTS 未找到此线程的前一个异常。
CCI_NO_THREADS_AVAILABLE 没有可分派的线程。
CCI_NULL_ADDR 应返回地址的函数失败;而返回了零。
CCI_PARSER_NAME_TOO_LONG 解析器类的名称太长。
CCI_SUCCESS 成功完成。
CCI_SUCCESS_CONTINUE cniRun() 返回值:落实消息处理并继续执行线程
CCI_SUCCESS_RETURN cniRun() 返回值:落实消息处理并将线程返回到池
CCI_TIMEOUT cniRun() 返回值:不处理消息但继续执行线程
注:
  1. 只有 cniGetLastExceptionData 会返回此返回码,指出最后一个异常的类型。
相关参考
C 通用实用程序函数
头文件
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08557_