ToC path:

mco_db_free_pages
RT

Return the count of available pages.

Prototype

 
    MCO_RET mco_db_free_pages(	/*IN*/ mco_db_h h, /*OUT*/ uint4 * free_pages );

Arguments

db	The database handle that was established by `mco_db_connect()`.
free_pages	The address of a `uint4` variable to receive the number of free pages.

Description

This function returns into free_pages the count of available pages in the database referenced by handle db.

Return Codes

MCO_S_OK	The free page count was returned successfully.
MCO_E_INVALID_HANDLE	Database handle not opened.

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;
        uint4 free_pages;
        ...
         
        if( (rc = mco_runtime_start()) != MCO_S_OK)
            exit(-1);
             
        rc = mco_db_open_dev( dbname, simple_get_dictionary(), &dev, 1, &db_params );
             
        if ( MCO_S_OK != rc )
        {
            rc = mco_db_connect(  dbname, &db );
            ...
            rc = mco_db_free_pages(db, &free_pages);

        }
        ...
    }

Files

Header file:

mco.h

Source file:

mcodb.c

Library:

libmcolib.a

mco_db_free_pagesRT

Prototype

Arguments

Description

Return Codes

Example

Files

mco_db_free_pages
RT