mco_db_close

接口适用于实时数据库 RT 。

关闭数据库。

此函数会销毁名为 dbname 的数据库。数据将被丢弃。所有指向该数据库的句柄都将失效。

内存不会被释放，调用应用程序有责任为数据库分配和释放内存。

    MCO_RET	mco_db_close(	
    	/*IN*/ const char * dbname
    );

参数

dbname

const char *

要关闭的数据库名称。它与传递给 mco_db_open() 的名称相同。

返回

MCO_S_OK

已成功关闭数据库。

MCO_E_NOINSTANCE

指定的数据库未打开。

MCO_E_OPENED_SESSIONS

存在与数据库的开放连接。（首先为所有开放会话调用 mco_db_disconnect() 函数。）

示例

    /*  应用程序代码片段 */

     
    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;
        ...
         
        if( (rc = mco_runtime_start()) != MCO_S_OK)
            exit(-1);
             
        rc = mco_db_open_dev( dbname, simpledb_get_dictionary(), &dev, 1, &db_params );
        if ( MCO_S_OK != rc )
        {
            ...
            rc = mco_db_close( dbname );

            ...
        }
    }

文件

• 头文件：mco.h
• 源文件：mcodb.c
• 库：libmcolib.a