# EssSetApplicationAccess

Description

EssSetApplicationAccess() sets a list of user application access structures, which contain information about user access to applications.

Syntax

    ESS_FUNC_M  EssSetApplicationAccess (hCtx, Count, pUserApp);

ESS_HCTX_T | hCtx
ESS_USHORT_T | Count
ESS_PUSERAPP_T | pUserApp

Parameters

hCtx | Essbase API context handle.
Count | Count of user application structures.
PUserApp | Pointer to an array of user application structures.

Return Value

None.

Notes

- The Access field of the user application structure is used to set the user's granted access to the application. For this call the MaxAccess field is ignored.

Access

This function requires the caller to have application Design privilege (ESS_PRIV_APPDESIGN) for the specified application.

Example

    ESS_FUNC_M
    ESS_SetApplicationAccess (ESS_HCTX_T  hCtx)
    {
       ESS_FUNC_M      sts = ESS_STS_NOERR;
       ESS_USHORT_T  Count;
       ESS_USERAPP_T UserApp;
       strcpy(UserApp.UserName,"Jim Smith");
       strcpy(UserApp.AppName,"Sample");
       UserApp.Access     = ESS_PRIV_APPDESIGN;
       UserApp.MaxAccess  = ESS_PRIV_APPDESIGN;
       sts = EssSetApplicationAccess(hCtx, Count,
            &UserApp);
       return (sts);
    }

See Also

EssGetApplicationAccess()
EssListUsers()
EssSetDatabaseAccess()
EssSetUser()