int db_init( SQLCA * sqlca );

成功した場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

この関数は、データベースインターフェイスライブラリを初期化します。この関数は、他のライブラリが呼び出される前、および Embedded SQL 文が実行される前に呼び出します。インターフェイスライブラリがプログラムのために必要とするリソースは、この呼び出しで割り付けられて初期化されます。

プログラムの最後でリソースを解放するには db_fini を使用します。処理中にエラーが発生した場合は、SQLCA に渡されて 0 が返されます。エラーがなかった場合は、0 以外の値が返され、Embedded SQL 文と関数の使用を開始できます。

通常は、この関数を一度だけ呼び出して、ヘッダーファイル sqlca.h に定義されているグローバル変数 sqlca のアドレスを渡してください。DLL または Embedded SQL を使用する複数のスレッドがあるアプリケーションを作成する場合は、使用する SQLCA ごとに 1 回ずつ db_init を呼び出します。

UltraLite アプリケーションでは、同等の db_init メソッドがあります。

• SQLCA (SQL Communication Area)
• マルチスレッドまたは再入可能コードでの SQLCA 管理
• db_init メソッド