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

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - 编程 » SQL Anywhere 数据访问 API » SQL Anywhere 嵌入式 SQL » 库函数参考

 

db_stop_engine 函数

原型
unsigned int db_stop_engine( SQLCA * sqlca, char * parms );
参数
  • sqlca   指向 SQLCA 结构的指针。有关信息,请参见SQL 通信区域 (SQLCA)

  • parms   以空值终止的字符串,其中包含以分号分隔的参数设置列表,每个参数设置的形式均为 KEYWORD=value。例如,
    "UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"

    有关连接参数的列表,请参见连接参数

说明

停止数据库服务器的执行。此函数执行的步骤有:

  • 查找名称与 ServerName (ENG) 参数匹配的本地数据库服务器。如果未指定 ServerName,则查找缺省的本地数据库服务器。

  • 如果找不到匹配的服务器,则此函数成功返回。

  • 向服务器发送一个请求,让服务器执行检查点操作并关闭所有数据库。

  • 卸载数据库服务器。

缺省情况下,此函数不停止有现有连接的数据库。如果 Unconditional 为 yes,则不管是否存在现有连接都会停止数据库服务器。

C 程序可以使用此函数,而不用正在生成的 dbstop。返回值 TRUE 指示没有错误。

是否可以使用 db_stop_engine 取决于在 -gk 服务器选项上的权限设置。请参见-gk 服务器选项