EssGLoginSetPass

Description

EssGLoginSetPass() connects a grid to an Essbase database, and changes the user password.

Syntax

ESS_FUNC_M EssGLoginSetPass() (hGrid, Server, Username, Password, NewPassword);

ESSG_HGRID_ThGrid;
ESSG_SERVER_TServer;
ESSG_USERNAME_TUsername;
ESSG_PASSWORD_TPassword;
ESSG_PASSWORD_TNewPassword;

Parameters

hGridHandle from EssGNewGrid()
ServerName of a valid server
UsernameName of a valid user on the server
PasswordUser's password
NewPasswordUser's new password

Return Value

If successful, returns ESSG_STS_NOERR.

Notes

Access

Example

#include 
#include 

{
  ESSG_FUNC_M     sts = ESS_STS_NOERR;
  ESSG_INIT_T     InitStruct;
  ESSG_HANDLE_T   Handle;
  ESSG_SERVER_T   Server;
  ESSG_USERNAME_T UserName;
  ESSG_PASSWORD_T Password;
  ESSG_PASSWORD_T NewPassword;
  ESSG_HGRID_T    hGrid;

  InitStruct.ulVersion      = ESSG_VERSION;
  InitStruct.ulMaxRows      = 1000;
  InitStruct.ulMaxColumns   = 200;
  InitStruct.pfnMessageFunc = ESS_NULL;
  InitStruct.pUserdata      = ESS_NULL;

  /* initializes EGAPI */
  sts = EssGInit(&InitStruct, Handle);

  /* initializes a specific grid */
  if(!sts)
    sts = EssGNewGrid(Handle, &hGrid);

    strcpy(Server, "Rainbow");
    strcpy(UserName, "Admin");
    strcpy(Password, "Password");
    strcpy(Password, "NewPassword");

  /* connects the grid to a database on the server */ 
  if(!sts)
    sts = EssGLoginSetPass(hGrid, Server, UserName, Password, NewPassword);
}

See Also

Grid API Concepts
Grid API Structures
EssAutoLogin()
EssGConnect
EssGInit()
EssInit()
EssLogout()