EssPartitionOpenDefFile

既存の共有パーティションの定義ファイルを開きます。

構文

            ESS_FUNC_M EssPartitionOpenDefFile (
            hCtx, pszFileName, piFileHandle, ppDdbCtx
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
pszFileName	ESS_STR_T	作成するファイルの名前(完全パス)。
piFileHandle	ESS_PINT_T	作成されたファイルへのハンドル。
ppDdbCtx	ESS_PART_T	初期化された配布コンテキスト。

備考

この関数は、一連の定義操作の一部として使用します。

EssPartitionOpenDefFileを使用して、既存の定義ファイルを開きます。
EssPartitionNewDefFileを使用して、新規定義ファイルを作成し開きます。
EssPartitionReadDefFileを使用して定義ファイルを読み取ります。または、EssPartitionWriteDefFileを使用して定義ファイルに書き込みます。
EssPartitionCloseDefFileで閉じます。
EssPartitionFreeDefCtxでメモリーを解放します。

戻り値

正常終了の場合は0が戻され、失敗した場合はエラー・コードが戻されます。

例

         ESS_FUNC_M ESS_PartitionOpenDefFile(ESS_HCTX_T hCtx)
{
   ESS_FUNC_M        sts = 0;
   ESS_INT_T        iFileHandle;
   ESS_STR_T        pszFileName;
   ESS_PART_T       DdbCtx, *pDdbCtx; 
   pszFileName = "C:\\Hyperion\\products\\Essbase\\EssbaseServer\\app\\app1\\trg1\\trg1.ddb";
   sts = EssPartitionOpenDefFile(hCtx,pszFileName,&iFileHandle,&pDdbCtx);
   printf("EssPartitionOpenDefFile  sts: %ld\n",sts);

   if (!sts)  
   {  
           sts = EssPartitionReadDefFile(hCtx,iFileHandle,&DdbCtx);
           printf("\tEssPartitionReadDefFile  sts: %ld\n",sts);

       /* ...
          ...  process definition file information
          ...
       */
           sts = EssPartitionCloseDefFile(hCtx,iFileHandle);
                
       printf("\tEssPartitionCloseDefFile   sts: %ld\n",sts);

           sts = EssPartitionFreeDefCtx(hCtx,pDdbCtx);
                
       printf("\tEssPartitionFreeDefCtx   sts: %ld\n",sts);

   }
   return (sts);
}