EssArchiveBegin

サーバー・モードを読取り専用に変更して、サーバーでアーカイブの準備をします。

構文

            ESS_FUNC_M EssArchiveBegin (
            hCtx, AppName, DbName, FileName
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル
AppName	ESS_STR_T	アーカイブするアプリケーション名
DbName	ESS_STR_T	アーカイブするデータベース名
FileName	ESS_STR_T	アーカイブ情報を含むファイルの名前

備考

この関数はサーバー・モードを読取り専用に変更します。このモードによって、データベース管理者はサーバー上のすべてのファイルをバックアップでき、バックアップ中にファイルに書き込まれないようにします。バックアップするデータベース・ファイルは、FileNameパラメータで指定されるapp\dbディレクトリにリストされます。
指定したファイル内の既存の情報はすべて、アーカイブされたデータによって上書きされます。

戻り値

なし。

アクセス

呼出し元は、少なくともデータベースに対する読取りアクセス権(ESS_PRIV_READ)を持ち、EssSetActiveを使用してそのデータベースをアクティブなデータベースとして選択する必要があります。

例

         ESS_FUNC_M 
ESS_ArchiveBegin(ESS_HCTX_T hCtx)
{
   ESS_FUNC_M       sts = ESS_STS_NOERR;
   ESS_STR_T    AppName;
   ESS_STR_T    DbName;
   ESS_STR_T    FileName;
   AppName  = "Sample";
   DbName   = "Basic";
   FileName = "Test.arc";
  
   /* Begin Archive */
   sts = EssArchiveBegin(hCtx, AppName, DbName,
         FileName);
   return (sts);
}