EssGetApplicationInfo

ユーザーが構成不可能なアプリケーションのパラメータが含まれている、アプリケーションの情報構造体を取得します。

構文

            ESS_FUNC_M EssGetApplicationInfo (
            hCtx, AppName, ppAppInfo
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル(ログイン済)。
AppName	ESS_STR_T	アプリケーション名。
ppAppInfo	ESS_APPINFO_T	割り当てられたアプリケーション情報構造体を受け取るポインタのアドレス。

備考

この関数は、サーバー上のアプリケーションに対してのみ呼び出せます。
ppAppInfoに対して割り当てられたメモリーは、EssFreeを使用して解放する必要があります。

戻り値

正常終了の場合は、割り当てられたアプリケーション情報構造体へのポインタがppAppInfoに戻されます。

アクセス

この関数を使用するには、呼出し元が少なくとも指定されたアプリケーションに対する読取りアクセス権(ESS_PRIV_READ)を持っている必要があります。

例

         ESS_FUNC_M
ESS_GetAppInfo (ESS_HCTX_T       hCtx,
                ESS_HINST_T      hInst
               )
{
   ESS_FUNC_M        sts = ESS_STS_NOERR;
   ESS_PAPPINFO_T   AppInfo;        
   ESS_USHORT_T     ind;
   ESS_STR_T        AppName;
   AppName = "Sample";

   sts = EssGetApplicationInfo (hCtx, AppName, &AppInfo);
   if (!sts)
   {      
      if (AppInfo)
      {   
         printf ("\r\n-------Application Info-------\r\n\r\n");
         printf ("Name            : %s\r\n", AppInfo->Name);
         printf ("Server Name     : %s\r\n", AppInfo->Server);
         printf ("Status          : %d\r\n", AppInfo->Status);
         printf ("Users Connected : %d\r\n", AppInfo->nConnects);
         printf ("Number of DBs   : %d\r\n", AppInfo->nDbs);
         printf ("\r\n--List of Databases--\r\n\r\n");
         for (ind = 0; ind < AppInfo->nDbs; ind++)
            printf ("database(%d)    : %s\r\n", ind,
                     AppInfo->DbNames [ind]);
         EssFree (hInst, AppInfo);
      }
   }
     
  return (sts);
}