EssGGetMemberInfo

1つの次元からメンバーの関係情報が戻されます。

構文

            ESSG_FUNC_M 
            EssGGetMemberInfo
             (
            hGrid, pszMbrName, sAction,
bAliases, pulMembers, ppszMembers
            );

パラメータ	データ型	説明
hGrid ;	ESSG_HGRID_T	EssGNewGridから戻されるハンドル。
pszMbrName;	ESSG_STR_T	関係情報を取得するメンバーの名前。
sAction;	ESSG_SHORT_T	どのようなタイプの関係情報を戻すのかを示す番号。このパラメータに有効な値(相互に排他的): ESSG_NEXTLEVEL子 ESSG_ALLLEVELSすべてのメンバー ESSG_BOTTOMLEVEL最下位レベル ESSG_SIBLEVEL兄弟レベル ESSG_SAMELEVEL同一レベル ESSG_SAMEGENERATION同世代 ESSG_CALCLEVEL計算 ESSG_PARENTLEVELメンバーの親 ESSG_TOPLEVELメンバーが属する次元
bAliases ;	ESSG_BOOL_T	別名が戻されるかどうかを指定します。
pulMembers;	ESSG_PULONG_T	戻されるメンバーの数。
*ppszMembers;	ESSG_PSTR_T	サーバーから戻されるpulMembersのサイズのメンバーの1次元配列を指すポインタ。APIがこのメモリーを割り当て、呼出し元が解放する必要があります。

備考

pszMbrNameには、NULLを指定できません。
EssGFreeMemberInfoを使用してppszMembersパラメータを解放します。

戻り値

正常終了の場合は、ESSG_STS_NOERRが戻されます。

アクセス

なし。

例

         ESSG_VOID_T ESSG_GetMemberInfo(ESSG_HGRID_T hGrid)

{
  ESSG_FUNC_M  sts = ESS_STS_NOERR;
  ESSG_STR_T         pszMbrName;
  ESSG_SHORT_T       sAction;
  ESSG_BOOL_T        bAliases;
  ESSG_ULONG_T       ulMembers, ind;
  ESSG_PSTR_T        pszMembers;
  char tmp[5] = "Year";

  pszMbrName = tmp;
  sAction = ESSG_NEXTLEVEL;
  bAliases = ESSG_FALSE;
    
  /* connect the grid to a database on the server */
  sts = EssGConnect(hGrid, "Rainbow", "Admin", 
        "Password", "Demo", "Basic",
        ESSG_CONNECT_NODIALOG);
   
  /* get member information */
  if(sts == 0)
     sts = EssGGetMemberInfo(hGrid,pszMbrName, sAction, bAliases, 
           &ulMembers, &pszMembers);
   
  if (sts == 0)
  {
     printf("\nNext Level of %s:\n", pszMbrName);
for (ind = 0; ind < ulMembers; ind++)
     printf("\t%s\n", *(pszMembers + ind));
       
     EssGFreeMemberInfo(hGrid, ulMembers, pszMembers);
  }
  if(!sts)
     sts = EssGDisconnect(hGrid, 0);   
}