EssEndCalc

アクティブなデータベースに送信される計算スクリプトの終わりをマークします。この関数は、EssSendStringを使用して計算スクリプトを送信した後に呼び出す必要があります。

構文

            ESS_FUNC_M EssEndCalc (
            hCtx
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。

備考

この関数より前にEssBeginCalcを呼び出して、少なくとも1回はEssSendStringを呼び出している必要があります。
EssBeginCalc、EssSendStringおよびEssEndCalcの呼出しが正常に行われた場合、呼出し元はESS_STATE_DONEが戻されるまでEssGetProcessStateを呼び出して、プロセスが完了したことを定期的に確認する必要があります。

戻り値

なし。

アクセス

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

例

         ESS_FUNC_M
ESS_Calc   (ESS_HCTX_T         hCtx)
{
   ESS_FUNC_M          sts = ESS_STS_NOERR;
   ESS_STR_T         Script;
   ESS_PROCSTATE_T   pState; 
   Script = "CALC ALL;";
            
   sts = EssBeginCalc (hCtx,ESS_TRUE);
   if (!sts)
      sts = EssSendString (hCtx, Script);
   if (!sts)
      sts = EssEndCalc (hCtx);
   if (!sts)
   {
      sts = EssGetProcessState (hCtx, &pState);
      while (!sts && (pState.State != 
             ESS_STATE_DONE))
        sts = EssGetProcessState (hCtx, &pState);   
   }
   return(sts);
}