Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
unsigned int db_stop_engine( SQLCA * sqlca, char * parms );
sqlca 指向 SQLCA 结构的指针。
parms 以空值终止的字符串,其中包含以分号分隔的参数设置列表,每个参数设置的形式均为 [关键字=值]。例如:
"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"
成功返回非零值;否则返回 0。
停止数据库服务器的执行。此函数执行的步骤有:
查找名称与 ServerName (Server) 参数匹配的本地数据库服务器。如果未指定 ServerName,则查找缺省的本地数据库服务器。
如果找不到匹配的服务器,则此函数成功返回。
向服务器发送一个请求,让服务器执行检查点操作并关闭所有数据库。
卸载数据库服务器。
缺省情况下,此函数不停止有现有连接的数据库。如果指定了 Unconditional=yes 连接参数,则不管是否存在现有连接都会停止数据库服务器。
C 程序可以使用此函数,而不用正在生成的 dbstop。返回值 TRUE 指示没有错误。
能否使用 db_stop_engine 取决于使用 -gk 服务器选项设置的特权。