EssGetDrillThruURL

アクティブなデータベース・アウトライン内のドリルスルーURLを取得します。

構文

            ESS_FUNC_M EssGetDrillThruURL (
            hCtx, URLName, &pUrl
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
URLName	ESS_STR_T	ドリルスルーURL名。
pUrl	ESS_PDURLINFO_T	URL定義。

戻り値

正常に処理されると、アクティブなデータベース・アウトライン内のドリルスルーURLが取得されます。
処理に失敗すると、エラー・コードが戻されます。

アクセス

呼出し側は、指定したデータベースに対してデータベース読取り権限(ESS_PRIV_READ)を持っている必要があります。
呼出し側はEssSetActiveを使用して、指定したデータベースをアクティブ・データベースとして選択しておく必要があります。

例

         static void DisplayUrlDefn (ESS_PDURLINFO_T pUrls )
{
   ESS_UINT_T	i;

   printf("\tUrlname        : %s\n", pUrls->cpURLName );
   if (pUrls->bIsLevel0)
      printf("\tUrl Is Level-0 slice : Yes\n");
   else
      printf("\tUrl Is Level-0 slice : No\n");
	
   printf("\tUrlXmlsize    : %i\n", pUrls->iURLXmlSize );
   printf("\tUrlXml        : %s\n", (ESS_STR_T) pUrls->cpURLXml);

   printf("\tNumber of drill region(s): %d\n", pUrls->iCountOfDrillRegions);
   for ( i = 0; i < pUrls->iCountOfDrillRegions; i++ )
   {
   printf("\t\tDrillRegion[%d]: %s\n", i, pUrls->cppDrillRegions[i] );
   }
   printf("\n");
}
ESS_STS_T sts = ESS_STS_NOERR;
ESS_STR_T urlName = "";
ESS_USHORT_T usCountOfURLs, i;
ESS_PDURLINFO_T urlInfo;

/* Valid case*/

urlName = "Drill Through to EPMI";
sts = EssGetDrillThruURL(hCtx, urlName, &urlinfo);
printf("EssGetDrillThruURL sts: %ld\n",sts);
if(!sts)
   DisplayUrlDefn(urlInfo);

EssFreeStructure (hInst, ESS_DT_STRUCT_URLINFO, 1, (ESS_PVOID_T)urlInfo);