Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
Ultra Light ランタイムライブラリを初期化します。
unsigned short db_init( SQLCA * sqlca );
処理中にエラーが発生した場合は 0 (たとえば永続ストアの初期化時)。エラー情報は SQLCA に設定されます。
エラーが発生しなかった場合は 0 以外。Embedded SQL コマンドと関数の使用を開始できます。
この関数は、他の Ultra Light ライブラリを呼び出す前、および Embedded SQL コマンドを実行する前に呼び出す必要があります。
通常は、この関数を 1 回だけ呼び出して、ヘッダーファイル sqlca.h に定義されているグローバル変数 sqlca のアドレスを渡してください。アプリケーションに複数の実行パスがある場合、複数の db_init を呼び出すことができます。ただし、それぞれに別個の sqlca ポインターが必要です。この別個の SQLCA ポインターには、ユーザーが定義したものを使用するか、db_fini で解放されたグローバル SQLCA を使用します。
マルチスレッドアプリケーションでは、各スレッドは、別個の SQLCA を獲得するために db_init を呼び出します。同じ SQLCA を使用する接続とトランザクションは、1 つのスレッドで続けて実行してください。
SQLCA を初期化すると、その前の ULEnable 関数呼び出しによる設定がすべてリセットされます。SQLCA を再初期化する場合は、アプリケーションで必要な ULEnable 関数をすべて発行する必要があります。