Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - C 及 C++ 编程 » API 参考 » 嵌入式 SQL API 参考

 

ULDropDatabase 函数

删除 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
};