版本:latest

SQLError

功能描述

用于获取错误和警告信息。

原型

c
SQLRETURN  SQLError(SQLHENV       EnvironmentHandle, 
                    SQLHDBC       ConnectionHandle,
                    SQLHSTMT      StatementHandle, 
                    SQLCHAR       *Sqlstate,
                    SQLINTEGER    *NativeError, 
                    SQLCHAR       *MessageText,
                    SQLSMALLINT   BufferLength, 
                    SQLSMALLINT   *TextLength);

参数

表 1 SQLError参数

关键字

参数说明

EnvironmentHandle

环境句柄,通过SQLAllocHandle获得。

ConnectionHandle

连接句柄,通过SQLAllocHandle获得。

StatementHandle

语句句柄,通过SQLAllocHandle获得。

Sqlstate

指向接收SQLSTATE字符串缓冲区的指针。

NativeError

指向接收数据源原生错误码的缓冲区指针。

MessageText

指向接收错误消息文本的缓冲区。

BufferLength

错误消息缓冲区的最大长度,以字节为单位。

TextLength

指向缓冲区的指针,用于返回MessageText中可用的总字节数。

返回值

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:表示错误信息获取失败。
  • SQL_INVALID_HANDLE:表示传入的句柄无效。
  • SQL_NO_DATA:表示没有错误信息可获取。

示例

参见:示例