mco_db_save_dictionary

将数据库词典保存到外部文件。

此函数用于将数据库模式（以 SmartEDB DDL 格式）流式传输到永久存储。

    MCO_RET	mco_db_save_dictionary(	
    	/*IN*/ void * stream_handle,
        /*IN*/ mco_stream_write output_stream_writer,
        /*IN*/ mco_db_h db
    );

参数

stream_handle

void *

输出流的句柄。

output_stream_writer

mco_stream_write

运行时调用的处理程序函数，用于格式化输出。

db

mco_db_h

数据库句柄。

MCO_S_OK

已成功保存数据库镜像。

MCO_E_NOINSTANCE

指定的数据库未打开。

MCO_E_WRITE_STREAM

写入输出流时出错。

示例

    /*  应用程序代码片段 */
        
     
    const char * dbname = "SimpleDb";
     
    /* 具有原型 mco_stream_write 的流写入器 */
    mco_size_sig_t file_writer( void *stream_handle /* FILE *  */, const void *from, mco_size_t nbytes )
    {
        FILE *f = (FILE *)stream_handle;
        mco_size_sig_t nbs;
        nbs = fwrite( from, 1, nbytes, f );
        return nbs;
    }
     
    int main(int argc, char* argv[])
    {
        mco_db_h db;
        MCO_RET rc;
        mco_db_params_t    db_params;
        FILE * fbak;
        mco_device_t       dev;
        ...
         
        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_connect(dbname, &db);
            ...
             
            /* 备份字典 */
            fbak = fopen( "dictionary.bak", "wb" );
            if ( fbak == 0 ) 
            {
                printf( "\n\t Can't open output file for streaming\n");
            }
            else 
            { 
                rc = mco_db_save_dictionary( (void *)fbak, file_writer, db );
        
                fclose( fbak );
                sample_rc_check( "\t Save dictionary", rc );
            }
            ...
        }
    }

文件

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