EssLoginExAs

管理者ユーザー名とパスワードではなくユーザー認証トークンを使用して、管理者を別のユーザーとしてEssbaseサーバーにログインさせます。この関数は通常、EssInitの呼出しを正しく実行した後で、かつコンテキスト・ハンドルの引数が必要な他のAPIの呼出しを実行する前に呼び出す必要があります。

別なユーザーとしてログインすることで、管理者はユーザーごとの許可を設定して、レポートのスケジュールを作成できます。

構文

            ESS_FUNC_M EssLoginExAs (
            hInstance, Server, Token, UserNameAs, pDbCount, ppDbList, phCtx
            );

パラメータ	データ型	説明
hInstance	ESS_HINST_T	APIインスタンス・ハンドル。
Server	ESS_STR_T	ネットワーク・サーバー名の文字列。サーバー名は、hostname、hostname:port、またはAPSサーブレットのエンドポイントにEssbaseフェイルオーバー・クラスタ名を付加したURLとして表すことができます。次に例を示します: http://myhost:13080/aps/Essbase?clustername=Essbase-Cluster1 保護モード(SSL)の場合、URLの構文は次のとおりです http[s]://host:port/aps/Essbase?ClusterName=logicalName&SecureMODE=yesORno たとえば、 https://myhost:13080/aps/Essbase?clustername=Essbase-Cluster1&SecureMODE=Yes
Token	ESS_STR_T	認証されるユーザーのユーザー名とパスワードを表すトークン。
UserNameAs	ESS_STR_T	代行するユーザーのユーザー名文字列。
pDbCount	ESS_PUSHORT_T	アクセス可能なアプリケーションとデータベースのカウントを受け取る変数のアドレス。
ppDbList	ESS_APPDB_T	割り当てられたアプリケーション/データベース名構造体の配列を受け取るポインタのアドレス。
phCtx	ESS_PHCTX_T	Essbaseサーバー・コンテキスト・ハンドルへのポインタ。

備考

この関数が失敗した場合は、ユーザーのユーザー名とパスワードを確認するために、対応するEssLoginAs関数が自動的に呼び出されます。
ppDbListに対して割り当てられたメモリーは、EssFreeを使用して解放する必要があります。

戻り値

成功の場合、Essbaseサーバー・コンテキスト・ハンドルがphCtxに戻され、他のAPI関数への後続の呼出しで引数として使用できます。また、指定したユーザーがアクセス可能なデータベース数がpCountに戻され、アクセス可能なアプリケーションおよびデータベースのリストがppDbListに戻されます。

アクセス

別のユーザーとしてログインするには、管理者である必要があります。

この関数を呼び出す前に、EssInitを呼び出して、最初にAPIを初期化し有効なインスタンス・ハンドルを取得する必要があります。