Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - C 及 C++ 编程 » 应用程序开发 » 使用嵌入式 SQL 开发应用程序

 

初始化 SQL 通信区

SQL 通信区 (SQLCA) 是一个内存区域,用于在应用程序和数据库之间相互传递统计信息和错误。SQLCA 用作应用程序到数据库的通信链接的句柄。它被显式传递给与数据库通信的所有数据库库函数,并隐式地在所有嵌入式 SQL 语句中传递。

UltraLite 在生成的代码中定义一个 SQLCA 全局变量。预处理器生成全局 SQLCA 变量的外部引用。该外部引用名为 sqlca,类型为 SQLCA。实际的全局变量在导入库中声明。

在头文件 install-dir\SDK\Include\sqlca.h 中定义 SQLCA 类型。

声明 SQLCA (EXEC SQL INCLUDE SQLCA;) 之后,必须先通过调用 db_init 并将 SQLCA 传递给它来初始化通信区,然后应用程序才可以对数据库执行操作:

db_init( &sqlca );
SQLCA 提供错误代码

可引用 SQLCA 以测试特定错误代码。当数据库请求引起错误时,sqlcode 字段将含有一个错误代码。宏是为引用 sqlca 中的 sqlcode 字段和某些其它字段而定义的。


SQLCA 字段