EssCreateLocalContext

ローカルAPI操作で使用するローカルAPIコンテキストを作成します。

構文

            ESS_FUNC_M EssCreateLocalContext (
            hInstance, UserName, Password, phLocalCtx
            );

パラメータ	データ型	説明
hInstance;	ESS_HINST_T	APIインスタンス・ハンドル。
UserName;	ESS_STR_T	現在使用されていません。NULLに設定する必要があります。
Password;	ESS_STR_T	現在使用されていません。NULLに設定する必要があります。
phLocalCtx;	ESS_PHCTX_T	Essbaseローカル・コンテキスト・ハンドルを受け取る変数のアドレス。

備考

この関数はローカルAPI操作(ローカル・ファイル/オブジェクト関数など)へのアクセスを必要とする場合に呼び出す必要があります。EssInitを呼び出した後に呼び出します。
関数はクライアント・アプリケーションにつき1回呼び出すのみです。コンテキスト・ハンドルは、ローカルのAPI操作すべてに使用できます。
アプリケーションがローカル・オブジェクトへのアクセスを終了した場合は、EssDeleteLocalContextを呼び出す必要があります。

戻り値

正常終了の場合は、有効なローカル・コンテキスト・ハンドルがphLocalCtxに戻されます。

アクセス

この関数を使用するのに、特別な権限は必要ありません。

例

EssGetLocalPathの例を参照してください。