# mco_db_disconnect
RT

> Disconnect from a database.

### Prototype

        MCO_RET	mco_db_disconnect(	/*IN*/ mco_db_h db);

### Arguments

db | The database handle that was established by `mco_db_connect()`

### Description

> This function destroys the connection handle to the database and invalidates any existing transaction handles for the connection. The function verifies that there are no active transactions associated with the session being disconnected and returns non-fatal error `MCO_E_TRANS_NOT_CLOSED` otherwise.

### Return Codes

MCO_S_OK | The database connection was disconnected successfully
MCO_E_TRANS_NOT_CLOSED | There are active transactions associated with the session being disconnected

### Example

        Application snippet:

        const char * dbname = "SimpleDb";

        int main(int argc, char* argv[])
        {
            mco_db_h db;
            MCO_RET rc;
            mco_device_t       dev;
            mco_db_params_t    db_params;

            ...
            rc = mco_db_open_dev( dbname, simpledb_get_dictionary(), &dev, 1, &db_params );

            if ( MCO_S_OK != rc )
            {
                rc = mco_db_connect(  dbname, &db );
                ...
                rc = mco_db_disconnect( db );

                rc = mco_db_close( dbname );
                ...
            }
        }

### Files

Header file:
mco.h
Source file:
mcoabst.c
Library:
libmcolib.a