删除 UltraLite 数据库文件,同时删除任何关联的临时文件或工作文件。
ul_bool ULDropDatabase ( SQLCA * sqlca, ul_char * store-parms );
sqlca 指向 SQLCA 的指针。
store-parms 以空值终止的连接字符串,其中包含以分号分隔的参数设置列表,每个参数设置的形式均为 KEYWORD=value。
ul_true 数据库文件已成功删除。
ul_false 无法删除该数据库文件。详细的错误消息由 SQLCA 中的 sqlcode 字段定义。通常,失败的原因是文件名不正确,或者对该文件的访问被拒绝(可能由于某个应用程序打开了该文件)。
仅在以下情况中调用此函数:
不存在打开的数据库连接时
调用 db_init 之前或调用 calling db_fini 之后。
在 Palm OS 上,仅在以下情况中调用此函数:
未连接到数据库时
调用任何 ULEnable 之后。
此函数删除数据库文件和其中的所有数据。此操作是不可恢复的。因此,请谨慎使用此函数。
以下调用将删除 UltraLite 数据库文件 myfile.udb。
if( ULDropDatabase(&sqlca, UL_TEXT("file_name=myfile.udb") ) ){ // success }; |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |