db_start_engine 函数

unsigned int db_start_engine( SQLCA * sqlca, char * parms );

parms 以空值终止的字符串，其中包含以分号分隔的参数设置列表，每个参数设置的形式均为 [关键字=值]。例如：

"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"

成功返回非零值；否则返回 0。

如果数据库服务器尚未运行，则将其启动。

如果数据库已运行或已成功启动，则返回值为 TRUE（非零）并且将 SQLCODE 设置为 0。错误消息在 SQLCA 中返回。

下面对 db_start_engine 的调用将启动数据库服务器、加载指定数据库，以及将服务器命名为 demo。

db_start_engine( &sqlca, "DBF=demo.db;START=dbeng12" );

除非使用 ForceStart (FORCE) 连接参数并将其设置为 YES，否则 db_start_engine 函数将尝试在启动服务器前连接到服务器，来避免尝试启动已在运行的服务器。

当 ForceStart 连接被设置为 YES 时，在尝试启动服务器之前不尝试连接到服务器。这样，下面的一对命令就能够按预期方式工作：

强制启动一台新服务器并连接到它：

db_start_engine( &sqlda, 
  "START=dbeng12 -n server_2 mydb.db;ForceStart=YES" )

如果未使用 ForceStart (FORCE)，而且未使用 ServerName (Server) 参数，则第二个命令会尝试连接到 server_1。db_start_engine 函数不从 StartLine (START) 参数的 -n 选项获取服务器名。