SQL调用层接口标准入门（十二）返回码

（一）SQL调用层接口标准概述
（二）SQL调用层接口例程
（三）分配和释放资源的例程
（四）控制与SQL服务器连接的例程
（五）执行SQL语句的例程（上）
（六）执行SQL语句的例程（下）
（七）“目录例程”
（八）处理串值的例程
（九）取得诊断信息的例程
（十）控制事务的例程
（十一）取得关于SQL实现信息的例程

最后，介绍SQL调用层接口标准中的3个基本术语：

• 返回码
• 诊断区
• 描述符区

（十二）返回码

执行CLI例程会导致一种或多种条件。通过返回码表明执行的状态，或者作为调用CLI例程的结果，该CLI例程是CLI函数，或者作为CLI例程的ReturnCode参数值，该CLI例程是CLI过程。

返回码值及含义描述如下：

• 值0表明成功。CLI例程执行成功。
• 值1表明带条件成功。CLI例程执行成功，但导致完成条件：“警告”。
• 值100表明未发现数据。CLI例程执行成功，但导致完成条件：“没有数据”。
• 值99表明需数据。CLI例程未执行完成，因为需要额外数据。导致异常条件：“CLI特定条件——需要动态参数值”。
• 值-2表明无效句柄。CLI例程执行不成功，因为导致异常条件：“CLI特定条件——无效句柄”。
• 值-1表明错误。CLI例程执行不成功。导致异常条件，不是“CLI特定条件——无效句柄”，也不是“CLI特定条件——需要动态参数值”。

除了Error例程、GetDiagField例程和GetDiagRec例程之外，所有SQL调用层接口例程不仅提供返回码，在与正在使用的资源相关联的诊断区中，SQL调用层接口实现还记录有关完成条件和异常条件的信息，但不包括“CLI特定条件——无效句柄”的信息。例程“正在使用的资源”是指由输入句柄标识的资源。