db_string_disconnect 関数

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

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

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

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

この関数は、ConnectionName パラメータで識別される接続を解除します。他のパラメータはすべて無視されます。

文字列に ConnectionName パラメータを指定しない場合は、無名の接続が解除されます。これは、Embedded SQL DISCONNECT 文と同等の機能です。接続に成功した場合、戻り値は TRUE です。エラー情報は SQLCA に返されます。

この関数は、AutoStop=yes 接続パラメータを使用して起動されたデータベースへの接続が他にない場合は、そのデータベースを停止します。また、サーバが AutoStop=yes パラメータを使用してすでに起動されており、実行中のデータベースが他にない場合も、サーバは停止します。