C API 状态和错误代码



状态代码

各个 API 调用都返回一个状态代码。下表列出可以从 API 调用得到的状态代码。请使用下表来标识状态代码。

定义的名称 错误说明
SAI_OK 0 没有出错
SAI_ERROR 1 C API 中的普通错误
SAI_SQL_ERROR 2 发生 SQL 错误
SAI_CLIENT_ERROR 3 在 API 尝试与应用程序服务器进行通信时发生错误。

注:在进行 API 调用时,建议对照 SAI_OK 进行检查。


错误代码

当从 API 调用得到的状态代码为 SAI_ERROR 时,下列错误代码有效。关于 SAI_SQL_ERROR 代码列表,请参阅数据库手册。此外,也可引用“Tivoli SA-脚本语言参考”中的 SAI_CLIENT_ERROR 代码。

定义的名称 错误说明
SAI_WRONG_RESPONSE 4 服务器以错误消息来响应。
SAI_INVALID_RECORDS 5 对一个或多个返回记录的格式设置不当。
SAI_CONNECTION_FAILED 6 对应用程序服务器的连接不成功。
SAI_INVALID_AppServer 7 主机名和用于应用程序服务器的端口无效。
SAI_SUBMISSION_FAILURE 8 应用程序服务器没有正确地记录问题记录。
SAI_INVALID_PARAMETER 9 一个或多个消息参数不正确。
SAI_NO_DATA 10 没有从应用程序服务器返回数据。
SAI_INVALID_SCIM 11 指定的 SCIM 不存在。
SAI_CHECKSUM_FAILURE 12 将一个非初始化的提交结构传送给 API 调用。