EssOtlGetAggLevelUsage

保管された階層に適用されたビュー選択プロパティを戻します。

構文

            ESS_FUNC_M EssOtlGetAggLevelUsage (
            hOutline, hMember, pAgglevelUsage
            );

パラメータ	データ型	説明
hOutline	ESS_HOUTLINE_T	アウトラインのコンテキスト・ハンドル(入力)。
hMember	ESS_HMEMBER_T	メンバーのハンドル(入力)。
pAgglevelUsage	ESS_PSHORT_T	EssOtlSetAggLevelUsageマニュアル(出力)にリストされたレベル使用定数の1つ。

備考

この関数は、リリース9.3以上の集約ストレージ・データベースにのみ適用可能です。

戻り値

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

例

            ESS_STS_T         sts = ESS_STS_NOERR;
   ESS_HOUTLINE_T    hOutline = ESS_NULL;
   ESS_HMEMBER_T     hMember = ESS_NULL;
   ESS_SHORT_T       sAggLevelUsage = 0;

   /* code to assign hOutline variable omitted */
   /* code to assign hMember variable omitted */

   if (hOutline && hMember)
   {
       sts = EssOtlGetAggLevelUsage (hOutline, hMember, &sAggLevelUsage);
 if (sts)
   printf("Error (%ld) getting AggLevelUsage\n", sts);
 else
         printf("AggLevelUsage is: %d ", sAggLevelUsage);
         switch (sAggLevelUsage)
         {
         case ESS_AGGLEVELUSAGE_NOTSET : 
                  printf("(not set)\n");
                  break;
         case ESS_AGGLEVELUSAGE_DEFAULT : 
                  printf("(Default)\n");
                  break;
         case ESS_AGGLEVELUSAGE_ALL : 
                  printf("(All levels considered)\n");
                  break;
         case ESS_AGGLEVELUSAGE_NOAGGREGATION : 
                  printf("(Do not aggregate)\n");
                  break;
         case ESS_AGGLEVELUSAGE_BOTTOMONLY : 
                  printf("(Bottom level only considered)\n");
                  break;
         case ESS_AGGLEVELUSAGE_TOPONLY : 
                  printf("(Top level only considered)\n");
                  break;
         case ESS_AGGLEVELUSAGE_BOTTOMTOP : 
                  printf("(Never aggregate intermediate levels)\n");
                  break;
         case ESS_MULTIPLE_HIERARCHY_IS_ENABLED : 
 printf("(Error: Multiple hierarchies - hierarchy members are gen=2)\n");
                  break;
         case ESS_MULTIPLE_HIERARCHY_NOT_ENABLED : 
       printf("(Error: Single hierarchy - hierarchy member is gen=1)\n");
                  break;
         case ESS_NOT_HIERARCHY_MEMBER : 
    printf("(Error: This member does not carry agglevel information)\n");
                  break;
         default: printf("(Unrecognized response)\n");                                
      }
   }
   else
   {
       if (!hOutline)
          printf("Outline not provided\n");
       if (!hMember)
          printf("Member not provided\n");
   }