# EssResetUser

Description

EssResetUser() resets the user's security structure to its initial state.

Syntax

ESS_FUNC_M EssResetUser() (hCtx, UserName);

ESS_HCTX_T | hCtx;
ESS_STR_T | UserName;

Parameters

hCtx | Essbase API context handle
UserName | User name

Return Value

Returns zero (0) if successful.

Notes

The following user security parameters are reset to their initial state:

- LockedOut
- PwdChgNow
- Failcount
- LastLogin
- LastPwdChg
- Expiration

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_ResetUser (ESS_HCTX_T  hCtx)
    {
       ESS_FUNC_M      sts = ESS_STS_NOERR;
       ESS_STR_T  UserName = "William";

       sts = EssResetUser (hCtx, UserName);
       return (sts);
    }

See Also

EssInit()
EssLogin()
EssLogout()