mco_trans_start

启动数据库事务。

此函数为由 db 引用的数据库启动一个事务。所有数据库访问都必须在事务的范围内进行。此函数在数据库导航时以 MCO_READ_ONLY 事务类型调用。如果查找要修改（更新或删除）的数据库对象，则应指定 MCO_UPDATE 事务类型。要更新数据库对象，必须启动 MCO_READ_WRITE 事务，或者通过调用 mco_trans_upgrade() 函数升级当前事务。

    MCO_RET	mco_trans_start(	
        /*IN*/ mco_db_h db, 
        /*IN*/ MCO_TRANS_TYPE trans_type,
        /*IN*/ MCO_TRANS_PRIORITY priority,
        /*OUT*/ mco_trans_h * t 
    );

参数

db

mco_db_h

此数据库连接的数据库句柄的地址。

trans_type

MCO_TRANS_TYPE

一个取自枚举 MCO_TRANS_TYPE 的无符号单字节值。

priority

MCO_TRANS_PRIORITY

一个从枚举 MCO_TRANS_PRIORITY 中获取的两字节无符号值。

t

mco_trans_h *

用于接收事务句柄的 mco_trans_h 地址。

MCO_S_OK

已成功创建数据库。

MCO_ERR_TRN

发生数据库事务错误。

示例

    /*  应用程序代码片段 */
        
     
    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;
        mco_trans_h t;
                 
        ...
        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_trans_start(db, MCO_READ_WRITE, MCO_TRANS_FOREGROUND, &t);
        
            if ( MCO_S_OK == rc ) 
            {
                ...
                rc = mco_trans_commit( t );
                ...
            }
        }
        ...
    }

文件

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