Contents Index db_start_engine function db_stop_engine function

ASA Programming Guide
  Embedded SQL Programming
    Library function reference

db_stop_database function


Prototype 

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

Arguments 

sqlca    A pointer to a SQLCA structure. For information, see The SQL Communication Area (SQLCA).

parms    A NULL-terminated string containing a semi-colon-delimited list of parameter settings, each of the form KEYWORD=value. For example,

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

For an available list of connection parameters, see Connection parameters.

Description 

Stop the database identified by DatabaseName on the server identified by EngineName. If EngineName is not specified, the default server is used.

By default, this function does not stop a database that has existing connections. If Unconditional is yes, the database is stopped regardless of existing connections.

A return value of TRUE indicates that there were no errors.

The permission required to start and stop a database is set on the server command line. For information, see The database server.


Contents Index db_start_engine function db_stop_engine function