# 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()