SQLGetDiagRec

    原型

    表 1 SQLGetDiagRec参数

    返回值

    • SQL_SUCCESS：表示调用正确。
    • SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
    • SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。

    SQLGetDiagRec不发布自己的诊断记录。它用下列返回值来报告它自己的执行结果：

    • SQL_SUCCESS：函数成功返回诊断信息。
    • SQL_SUCCESS_WITH_INFO：MessageText太小以致不能容纳所请求的诊断信息。没有诊断记录生成。
    • SQL_INVALID_HANDLE：由HandType和Handle所指出的句柄是不合法句柄。

    如果调用ODBC函数返回SQL_ERROR或SQL_SUCCESS_WITH_INFO，可调用SQLGetDiagRec返回诊断信息值SQLSTATE，SQLSTATE值的如下表。

    表 2 SQLSTATE值

    SQLSATATE

    错误

    描述

    HY000

    一般错误

    未定义特定的SQLSTATE所产生的一个错误。

    HY001

    驱动程序不能分配所需要的内存来支持函数的执行或完成。

    HY008

    取消操作

    调用SQLCancel取消执行语句后，依然在StatementHandle上调用函数。

    HY010

    函数系列错误

    在为执行中的所有数据参数或列发送数据前就调用了执行函数。

    HY013

    内存管理错误

    不能处理函数调用，可能由当前内存条件差引起。

    HYT01

    连接超时

    数据源响应请求之前，连接超时。

    IM001

    驱动程序不支持此函数

    示例

    参见：