db_init 函数

初始化 UltraLite 运行时库。

语法

unsigned short db_init(
SQLCA * sqlca 
);

返回值

如果在处理过程中（例如，在持久存储区的初始化过程中）出现错误，则返回 0。在 SQLCA 中设置错误代码。
如果没有错误，则返回非零值。可以开始使用嵌入式 SQL 命令和函数。

注释

在进行任何其它 UltraLite 库调用之前，以及执行任何嵌入式 SQL 命令之前，都必须调用此函数。

在大多数情况下，只应调用一次此函数，传递全局 sqlca 变量的地址（如 sqlca.h 头文件中定义的）。如果应用程序中有多个执行路径，只要每个路径具有单独的 sqlca 指针，您就可以使用多个 db_init 调用。这个单独的 SQLCA 指针可以是用户定义的指针，也可以是用 db_fini 释放了的全局 SQLCA。

在多线程应用程序中，每个线程都必须调用 db_init 来获得单独的 SQLCA。在单个线程上执行使用此 SQLCA 的后续连接和事务。

初始化 SQLCA 还会重置任何先前调用 ULEnable 函数时的设置。如果重新初始化 SQLCA，必须发出应用程序需要的所有 ULEnable 函数。

另请参见

db_fini 函数