|
Deletes the UltraLite database file.
ul_bool ULDropDatabase ( SQLCA * sqlca, ul_char * store-parms );
sqlca A pointer to the SQLCA.
store-parms A null-terminated connection string containing a semicolon-delimited list of parameter settings, each of the form KEYWORD=value.
ul_true The database was successfully deleted.
ul_false The database could not be deleted. A detailed error message is defined by the sqlcode field in the SQLCA. The usual reason for failure is that an incorrect file name was supplied or that access to the file was denied (perhaps because it is opened by an application).
Only call this function when:
You do not have an open database connection.
Either before you have called db_init but after you have called db_fini.
On the Palm OS, only call this function only when:
You are not connected to the database.
After have called ULEnable functions.
| Caution
This function deletes the database file and all data in it. This operation is not recoverable. Therefore, use this function with care. |
The following call deletes the UltraLite database file myfile.udb.
if( ULDropDatabase(&sqlca, UL_TEXT("file_name=myfile.udb") ) ){
// success
};