EssUpdateFile

ファイルからアクティブ・データベースに対して更新指定を送信します。更新データはデータベースに保管することも、確認のみ行ってエラーがあれば戻すこともできます。また、この呼出しによって、更新用にロックされていたデータ・ブロックもロック解除できます。

構文

            ESS_FUNC_M  EssUpdateFile (
            hDestCtx, hSrcCtx, AppName, DbName, FileName, Store, Unlock
            );

パラメータ	データ型	説明
hDestCtx	ESS_HCTX_T	サーバー上のターゲット・データベースのAPIコンテキスト・ハンドル。
hSrcCtx	ESS_HCTX_T	レポート・ファイルの場所に対するAPIコンテキスト・ハンドル。レポート・ファイルは、クライアント、またはターゲット・データベースと同一のサーバー上に配置できます。
AppName	ESS_STR_T	更新ファイルの場所のアプリケーション名。
DbName	ESS_STR_T	更新ファイルの場所のデータベース名。
FileName	ESS_STR_T	更新指定ファイル名。
Store	ESS_BOOL_T	データの保管を制御します。TRUEの場合は、データがサーバーに保管されます。FALSEの場合はデータは保管されません。
Unlock	ESS_BOOL_T	データ・ブロックのロック解除を制御します。TRUEの場合、ロックされているすべての関連ブロックのロックが解除されます(必要に応じてデータの保管後)。FALSEの場合、ブロックのロックは解除されません。

備考

この関数によってデータが保管される場合(StoreフラグがTRUE)、関連データ・ブロックは更新のためにロックされている必要があります(たとえば、LockフラグをTRUEに設定してEssReportを呼び出します)。
StoreおよびUnlockの両方のフラグがFALSEに設定されている場合、データベースは更新指定の構文確認のみを行います。

戻り値

なし。

アクセス

この関数を使用するには、呼出し元が、アクティブなデータベースに対して書込み権限(ESS_PRIV_WRITE)を持っている必要があります。

例

         ESS_FUNC_M
ESS_UpdateFile (ESS_HCTX_T      hCtx)
{
   ESS_FUNC_M    sts = ESS_STS_NOERR;
   ESS_HCTX_T   hSrcCtx;
   ESS_BOOL_T   isStore;
   ESS_BOOL_T   isUnlock;
   ESS_STR_T    AppName;
   ESS_STR_T    DbName;
   ESS_STR_T    FileName;
   
   AppName  = "Sample";
   DbName   = "Basic";
   hSrcCtx  = hCtx;
   isStore  = ESS_TRUE;
   isUnlock = ESS_FALSE;
   sts = EssUpdateFile (hCtx, hSrcCtx, AppName,
         DbName, FileName, isStore, isUnlock);
   return(sts);
}