EssGetApplicationInfoEx

1つ以上のアプリケーションから情報を取得します。

構文

            ESS_FUNC_M EssGetApplicationInfoEx (
            hCtx, AppName, pusCount, ppAppInfoEx
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル(ログイン済)。
AppName	ESS_STR_T	情報が戻されるアプリケーション名。NULLの場合、すべてのアプリケーションについての情報が戻されます。
pusCount	ESS_PUSHORT_T	戻される情報構造体の数。
ppAppInfoEx	ESS_APPINFOEX_T	割り当てられたアプリケーション情報構造体の配列へのポインタのアドレス。

備考

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

戻り値

正常終了の場合は、アプリケーション情報構造体の配列がppAppInfoに戻されます。

アクセス

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

例

         ESS_FUNC_M
ESS_GetApplicationInfoEx (ESS_HCTX_T hCtx, ESS_HINST_T hInst)
{
   ESS_FUNC_M           sts = ESS_STS_NOERR;
   ESS_USHORT_T         ind;
   ESS_STR_T            AppName;
   ESS_USHORT_T         Count;
   ESS_PAPPINFOEX_T     AppInfoEx = NULL;
   
   AppName = "";
   sts = EssGetApplicationInfoEx (hCtx, AppName,
         &Count, &AppInfoEx);
   if(!sts)
   {
      if(AppInfoEx)
      {
printf("\n-----Application Info Ex -----\n\n");
         for (ind = 0; ind <Count; ind++)
         {
printf("Name:%s\r\n",AppInfoEx[ind].Name);
printf("Server Name:%s\r\n", AppInfoEx[ind].Server);
printf("Status:%d\r\n",AppInfoEx[ind].Status);
printf("Users Connected:%d\r\n", 
        AppInfoEx[ind].nConnects);
printf("\r\n");
         }
      EssFree(hInst, AppInfoEx);
      }
   }
   return (sts);
}