EssGetMemberInfo

アクティブ・データベース・アウトライン内の、特定のメンバーに関する情報が含まれている構造体を取得します。

構文

            ESS_FUNC_M EssGetMemberInfo (
            hCtx, MbrName, ppMbrInfo
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
MbrName	ESS_STR_T	メンバー名。
ppMbrInfo	ESS_MEMBERINFO_T	割り当てられたメンバー情報構造体を受け取るポインタのアドレス。

備考

EssFreeまたはEssFreeStructureを呼び出して、ppMbrInfoに動的に割り当てられたメモリーを解放します。
タイプESS_ATTRMBRDT_STRINGの属性メンバーの場合は、EssFreeStructureを呼び出してppMbrInfoに動的に割り当てられたメモリーを解放する必要があります。ESS_DT_STRUCT_MBRINFOを構造体IDとして指定します。EssFreeは、属性の文字列の値に動的に割り当てられたメモリーを解放しません。
ESS_MEMBERINFO_T構造体のStatusフィールドのESS_MBRSTS_ATTRIBUTE定数は、次元またはメンバーが属性次元または属性メンバーであることを示します。
ESS_MEMBERINFO_T構造体の次の2つのフィールドは、属性のみです:
- fAttributed
- Attribute
この関数は、リレーショナル・スパンのブール式が設定されており(EssSetSpanRelationalPartitionで設定)、リレーショナル・ストア内のメンバーに関する情報を戻すことができるかどうかを確認します。
ESS_MEMBERINFO_T構造体の次の2つのフィールドは、リレーショナル・ストア内のメンバーにのみ使用されます:
- fHasRelDesc
- fHasRelPartEnabled
ESS_MBRINFO_T構造体の次の2つのフィールドは、リレーショナル・ストア内のメンバーにのみ使用されます:
- fHasRelDesc
- fHasRelPartEnabled

戻り値

正常終了の場合は、この関数は割り当てられたメンバー情報構造体であるppMbrInfoを戻します。メンバーの親がない場合は、この関数はESS_MEMBERINFO_T構造体のParentMbrNameフィールドに空の文字列を戻します。

アクセス

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

例

         ESS_FUNC_M
ESS_GetMbrInfo (ESS_HCTX_T  hCtx,
                ESS_HINST_T hInst
               )
{
   ESS_FUNC_M         sts = ESS_STS_NOERR;
   ESS_MEMBERINFO_T  *pMbrInfo = NULL;
   sts = EssGetMemberInfo(hCtx, "Profit",
                &pMbrInfo);
   if (!sts)
   {      
      if (pMbrInfo)
      {
         EssFreeStructure(hCtx, structId, count, structPtr);
      }
   }
   return (sts);
}