EssDisplayAlias

アクティブ・データベース内の別名テーブルのコンテンツをダンプします。

構文

            ESS_FUNC_M EssDisplayAlias (
            hCtx, AliasName, pCount, ppAliases
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
AliasName	ESS_STR_T	別名テーブル名。
pCount	ESS_PUSHORT_T	別名のカウントを受け取る変数のアドレス。
ppAliases	ESS_MBRALT_T	メンバーの別名テーブルを受け取るポインタのアドレス。

備考

ppAliasesに対して割り当てられたメモリーは、EssFreeを使用して解放する必要があります。

戻り値

なし。

アクセス

この関数を使用するには、呼出し元がデータベースに対して少なくとも読取りアクセス権(ESS_PRIV_READ)を持っていて、EssSetActiveを使用してそのデータベースをアクティブなデータベースとして選択している必要があります。

例

         ESS_FUNC_M
ESS_DisplayAlias (ESS_HCTX_T    hCtx)
{
   ESS_FUNC_M     sts = ESS_STS_NOERR;
   ESS_USHORT_T  Count;
   ESS_USHORT_T  ind;
   ESS_PMBRALT_T Altlist;
   ESS_STR_T     AltName;     
  
   AltName = "TestAlias";
   
   sts = EssDisplayAlias (hCtx, AltName, &Count, &Altlist);
   if (Count)
   {   
      printf ("\r\n-----Alias Contents-----\r\n\r\n");
      
      for (ind = 0; ind < Count; ind++)
      {
          printf ("%s==>%s\r\n",
                   Altlist [ind].MbrName, Altlist [ind].AltName);
      }
      printf ("\r\n");
   }       
      
  return (sts);
}