# mco_db_databases
RT

> List all registered database names.

### Prototype

        MCO_RET	mco_db_databases(	/*OUT*/ char* lpBuffer,
                       /*IN*/ mco_size32_t buffer_size,
                       /*IN*/ mco_counter32_t skip_first);

### Arguments

lpBuffer | Buffer to receive database names
buffer_size | Size of the buffer
skip_first | Number of databases to skip over

### Description

> This function returns a list of all database names registered in the system.

### Return Codes

MCO_S_OK | The database names are successfully written to the buffer
MCO_E_NOMEM | Not enough memory in the buffer for the database names

### 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;
            char name_buffer[1024];

            ...
            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_databases(name_buffer, 1024, 0);

                printf("\n\n Database names:\n%s\n", name_buffer);
                ...
                rc = mco_db_disconnect( db );

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

### Files

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