EssCreateUser
Description
EssCreateUser() creates a new user.
Syntax
ESS_FUNC_M EssCreateUser (hCtx, UserName, Password);
ESS_HCTX_T | hCtx |
ESS_STR_T | UserName |
ESS_STR_T | Password |
Parameters
hCtx | Essbase API context handle. |
UserName | Name of user to create. User names can be 30 characters long.
|
Password | Security password for new user. Passwords can be up to 100 characters long.
|
Return
Value
None.
Notes
- The specified user must not already exist.
- The user's access level and other parameters may be set with
the EssSetUser() function.
- You program should ensure that the password has been entered
correctly (e.g. by requiring the user to type it twice) before
calling this function. Once entered, it is not possible to retrieve
a password. However, a password can be changed using the EssSetPassword()
function.
Access
This function requires the caller to have Create/Delete User privilege
(ESS_PRIV_USERCREATE) for the logged in server.
Example
ESS_FUNC_M
ESS_CreateUser (ESS_HCTX_T hCtx)
{
ESS_FUNC_M sts = ESS_STS_NOERR;
ESS_STR_T UserName;
ESS_STR_T Password;
UserName = "Jim Smith";
Password = "Password";
sts = EssCreateUser (hCtx, UserName, Password);
return (sts);
}
See
Also
EssDeleteUser()
EssListUsers()
EssRenameUser()
EssSetPassword()
EssSetUser()