db_stop_engine 関数

unsigned int db_stop_engine( SQLCA * sqlca, char * parms );

sqlca SQLCA 構造体へのポインタ。詳細については、SQLCA (SQL Communication Area)を参照してください。
parms NULL で終了された文字列で、KEYWORD=value 形式のパラメータ設定をセミコロンで区切ったリストが含まれています。次に例を示します。
"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"
接続パラメータのリストについては、接続パラメータを参照してください。

データベース・サーバの実行を終了します。この関数によって実行されるステップは次のとおりです。

ServerName (ENG) パラメータと一致する名前のローカル・データベース・サーバを探します。ServerName の指定がない場合は、デフォルトのローカル・データベース・サーバを探します。
一致するサーバが見つからない場合は、この関数は正常に値を返します。
チェックポイントをとってすべてのデータベースを停止するように指示する要求をサーバに送信します。
データベース・サーバをアンロードします。

デフォルトでは、この関数は既存の接続があるデータベース・サーバは停止させません。Unconditional が yes の場合は、既存の接続に関係なくデータベース・サーバは停止します。

C のプログラムでは、dbstop を生成する代わりにこの関数を使用できます。戻り値 TRUE は、エラーがなかったことを示します。

db_stop_engine の使用には、-gk サーバ・オプションで設定されるパーミッションが適用されます。-gk サーバ・オプションを参照してください。