ULDropDatabase 関数

Ultra Light データベース・ファイルと、関連するテンポラリ・ファイルまたはワーク・ファイルを削除します。

ul_bool ULDropDatabase ( 
SQLCA * sqlca, 
ul_char * store-parms
);

sqlca SQLCA へのポインタ。

store-parms KEYWORD=value の形式のパラメータ設定をセミコロンで区切ったリストからなる、NULL で終了された接続文字列。

ul_true データベース・ファイルが正常に削除されました。
ul_false データベース・ファイルを削除できませんでした。詳細なエラー・メッセージが、SQLCA の sqlcode フィールドに設定されています。よくある失敗の理由は、ファイル名が正しくない、別のアプリケーションでファイルが開かれているためファイルへのアクセスが拒否されたなどです。

この関数は、次の場合にだけ呼び出すようにしてください。

Palm OS では、次の場合にだけ呼び出すようにしてください。

この関数は、データベース・ファイルとその中のすべてのデータを削除します。この操作は元に戻せません。そのため、この関数を使用する場合は注意してください。

次の呼び出しは、Ultra Light データベース・ファイル myfile.udb を削除します。

if( ULDropDatabase(&sqlca, UL_TEXT("file_name=myfile.udb") ) ){
    // success
};