EssSetApplicationState

アプリケーションの状態構造体を使用して、ユーザーが構成可能なアプリケーションのパラメータを設定します。

構文

            ESS_FUNC_M  EssSetApplicationState (
            hCtx, AppName, pAppState
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
AppName	ESS_STR_T	アプリケーション名。
pAppState	ESS_APPSTATE_T	アプリケーション状態構造体へのポインタ。

備考

パラメータ値を変更するときは、最初にEssGetApplicationStateを呼び出して、変更しないパラメータの正しい値を取得することをお薦めします。
次のパラメータは集約ストレージ・データベースに適用されません:LockTimeoutおよびlroSizeLimit。

戻り値

なし。

アクセス

この関数を使用するには、指定されたアプリケーションに対して、呼出し元がアプリケーション・デザイナ権限(ESS_PRIV_APPDESIGN)を持っている必要があります。

例

         ESS_FUNC_M
ESS_SetAppState (ESS_HCTX_T   hCtx,
                 ESS_HINST_T  hInst
                )
{
   ESS_FUNC_M         sts = ESS_STS_NOERR;
   ESS_PAPPSTATE_T   AppState;
   ESS_STR_T         AppName;
   AppName = "Sample";
   
   sts = EssGetApplicationState (hCtx, AppName,
         &AppState);
   if (!sts)
   {      
      if (AppState)
      {   
         /*****************************
          * Update AppState structure *
          *****************************/
         sts = EssSetApplicationState (hCtx,
               AppName, AppState);
         EssFree (hInst, AppState);
   }
   return (sts);
}