Connects a grid to an Essbase database using a user authentication token rather than a username and password.
Syntax
ESSG_FUNC_M EssGConnectEx (hGrid, Server, Token, Application, Database, ulOptions);
| Parameter | Data Type | Description |
|---|---|---|
hGrid | ESSG_HGRID_T | Handle passed back from EssGNewGrid. |
Server | ESSG_SERVER_T | Network server name string. The server name can be expressed as hostname or hostname:port. |
Token | ESSG_TOKEN_T | The token representing the username and password of an authenticated user. |
Username | ESSG_USERNAME_T | Name of valid user at server. |
Password | ESSG_PASSWORD_T | Password of user. |
Application | ESSG_APPLICATION_T | Name of a valid application on server. |
Database | ESSG_DATABASE_T | Name of a valid database for application on server. |
ulOptions | ESSG_ULONG_T | Options flag. Values are ESSG_CONNECT_NODIALOG, which attempts to login and connect without displaying dialog, using the default/passed setting; or ESSG_CONNECT_DEFAULT which will display the login and selection dialog. |
Notes
If this function fails, the corresponding EssGConnect() function is automatically called in order to try to verify a username and password for the user.
Calls EssAutoLogin, therefore all rules that apply to EssAutoLogin apply to this function. For example, none of the parameters are case-sensitive.
If ulOptions is set to ESSG_CONNECT_NODIALOG, none of the connection related parameters can be NULL or empty. When ulOptions is set to ESSG_CONNECT_DEFAULT, and a buffer is passed for the connect parameters, the user's selections from the dialog will be returned in these buffers.
All security information is utilitized. Therefore, if the user connects to a database to which he or she does not have read access, all read operations will fail.
Return Value
If successful, returns ESSG_STS_NOERR.
Access
None.
See Also