iAnywhere.com - 初始化 SQL 通信区

SQL 通信区 (SQLCA) 是一个内存区域，用于将统计信息和错误从应用程序传送给数据库，以及回传给应用程序。SQLCA 用作应用程序到数据库的通信链接的句柄。它被显式传递给与数据库通信的所有数据库库函数，并隐式传递到所有嵌入式 SQL 语句中。

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

SQLCA 类型由 sqlca.h 头文件定义，该文件位于安装目录的 h 子目录中。

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

db_init( &sqlca );

可引用 SQLCA 测试特定错误代码。当数据库请求引起错误时，sqlcode 字段将含有一个错误代码（请参见下面的内容）。为引用 sqlcode 字段和一些其它字段，已定义了一些 C 语言宏。