mco_async_backup_start

启动异步备份进程。

有关概述，请参阅页面C中的增量备份和恢复。

原型

    MCO_RET mco_async_backup_start         ( /*IN*/ mco_db_h connection, 
                    /*IN*/ unsigned int backup_cycle_delay_msec,
                    /*IN*/ char const* file_name, 
                    /*IN*/ char const* label,
                    /*IN*/ mco_backup_type type, 
                    /*IN*/ int compression_level, 
                    /*IN*/ char const* cipher)

参数

connection	用于备份的数据库连接
backup_cycle_delay_msec	呼叫之间的停顿mco_backup_create () 从循环来看
file_name	备份文件的名称和位置
label	备份记录标签的前缀（可选）。该字符串将添加一个5位数的备份号码。如果没有给出，例程将把备份记录命名为“AUTOBACKUP#####”。
type	见下文。
compression_level	设置的备份压缩级别mco_async_backup_start ()
cipher	用于编码的可选密码

type

备份记录的类型：以下类型之一：

  typedef enum {
    MCO_BACKUP_TYPE_AUTO,
    MCO_BACKUP_TYPE_SNAPSHOT,
    MCO_BACKUP_TYPE_INCREMENTAL
  } mco_backup_type;

描述

该函数在数据库头中重置周期的上下文，并启动一个运行备份周期的线程。它使用数据库连接来访问数据库并创建自己的连接。（注意，备份周期创建一个到数据库的连接—该连接没有嗅探器上下文。）

返回

MCO_S_OK	备份周期已启动并运行
MCO_E_BACKUP	另一个备份/恢复任务已经启动或无法启动该线程
MCO_E_ILLEGAL_PARAM	参数值无效
MCO_ERR_DB_NOMEM_HEAP	数据库堆中没有存储循环上下文的空间

示例

    {
        char * db_name = “myDb”;
        mco_db_h con;
        MCO_RET rc;
 
        /* connect to a database */
        rc = mco_db_connect( db_name, &con );
 
        /* backup the database asynchronously */
        rc = mco_async_backup_start( con, 500, "file.backup", "label", MCO_BACKUP_TYPE_AUTO, 0, 0 );
    }