EssListLocks

ある特定のアプリケーションとデータベースに接続しているすべてのユーザーを、それらのユーザーが現在ロックしているデータ・ブロックのカウントとともにリストします。

構文

            ESS_FUNC_M EssListLocks (
            hCtx, AppName, DbName, pCount, ppLockList
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
AppName	ESS_STR_T	アプリケーション名。
DbName	ESS_STR_T	データベース名。
pCount	ESS_PUSHORT_T	ユーザーのカウントを受け取る変数のアドレス。
ppLockList	ESS_LOCKINFO_T	割り当てられたユーザー・ロック情報構造体の配列を受け取るポインタのアドレス。

備考

この関数は、この関数が呼び出されたときにサーバーに接続していたユーザーのみがリストされる場合にスナップショットになります。
ppLockListに対して割り当てられたメモリーは、EssFreeを使用して解放する必要があります。

戻り値

正常終了の場合は、接続しているユーザー数のカウントがpCountに、ユーザー・ロック構造体のリストがppLockListに戻されます。

アクセス

この関数を使用するには、呼出し元が、指定したデータベースに対してデータベース・デザイン権限(ESS_PRIV_DBDESIGN)を持っている必要があります。

例

         ESS_FUNC_M
ESS_ListLocks (ESS_HCTX_T   hCtx,
               ESS_HINST_T  hInst  
              )
{
   ESS_FUNC_M          sts;
   ESS_USHORT_T     Count;
   ESS_PLOCKINFO_T  plockinfo = NULL;
   ESS_STR_T        AppName;
   ESS_STR_T        DbName;
   AppName = "Sample";
   DbName  = "Basic";
   sts = EssListLocks (hCtx, AppName, DbName,
         &Count, &plockinfo); 
   if (!sts)
   {
      if (Count && plockinfo)
         EssFree (hInst, plockinfo);
      else
         printf ("\r\nExclusive Lock List on %s:%s is empty\r\n\r\n", AppName, DbName);
   }
   return (sts);
}