db_stop_engine 関数

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

parms NULL で終了された文字列で、KEYWORD=value 形式のパラメータ設定をセミコロンで区切ったリストが含まれています。次に例を示します。

"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"

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

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

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

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

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

db_stop_engine の使用には、-gk サーバオプションで設定される権限が適用されます。