EssGConnectEx

ユーザー名とパスワードではなくユーザー認証トークンを使用して、グリッドをEssbaseデータベースに接続します。

構文

            ESSG_FUNC_M 
            EssGConnectEx
             (
            hGrid, Server, Token, Application, Database, ulOptions
            );

パラメータ	データ型	説明
hGrid	ESSG_HGRID_T	EssGNewGridから戻されるハンドル。
Server	ESSG_SERVER_T	ネットワーク・サーバー名の文字列。サーバー名はhostnameまたはhostname:portで表すことができます。
Token	ESSG_TOKEN_T	認証されるユーザーのユーザー名とパスワードを表すトークン。
Username	ESSG_USERNAME_T	サーバー上の有効なユーザー名。
Password	ESSG_PASSWORD_T	ユーザーのパスワード。
Application	ESSG_APPLICATION_T	サーバー上の有効なアプリケーション名。
Database	ESSG_DATABASE_T	サーバー上にあるアプリケーションにおいて有効なデータベース名。
ulOptions	ESSG_ULONG_T	オプションのフラグ。値は、ダイアログを表示せずデフォルト、または渡された設定を使用してログインと接続を試行する場合はESSG_CONNECT_NODIALOGになります。ログインおよび選択のダイアログを表示する場合はESSG_CONNECT_DEFAULTになります。

備考

この関数が失敗した場合は、ユーザーのユーザー名とパスワードを確認するために、対応するEssGConnect()関数が自動的に呼び出されます。
EssAutoLoginが呼び出されるため、EssAutoLoginに適用されるすべてのルールがこの関数にも適用されます。たとえば、すべてのパラメータは大文字と小文字を区別しません。
ulOptionsがESSG_CONNECT_NODIALOGに設定されている場合、接続に関連するパラメータをNULLまたは空にできません。ulOptionsがESSG_CONNECT_DEFAULTに設定され、バッファが接続用パラメータに渡されると、ユーザーがダイアログで選択した内容がこれらのバッファに戻されます。
すべてのセキュリティ情報が使用されています。そのため、読取りアクセス権限のないデータベースに接続すると、すべての読取り操作が失敗します。

戻り値

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

アクセス

なし。