EssGetUserEx

Description

EssGetUserEx() gets a user information structure, which contains security information for the user.

Syntax

ESS_FUNC_M EssGetUserEx (hCtx, UserName, ppUserInfo);
ESS_HCTX_ThCtx
ESS_STR_TUserName
ESS_USERINFOEX_T ppUserInfoEx

Parameters

hCtxEssbase API context handle.
UserNameUser name.
ppUserInfoExAddress of pointer to receive info structure of externally authenticated user.

Return Value

If successful, returns the user information structure in ppUserInfo.

Notes

Access

This function requires the caller to have Create/Delete User privilege (ESS_PRIV_USERCREATE) for the logged in server, unless they are getting their own user information.

Example

ESS_FUNC_M
ESS_GetUserInfo (ESS_HCTX_T  hCtx,
                 ESS_HINST_T hInst
                )
{
   ESS_FUNC_M        sts  = ESS_STS_NOERR;
   ESS_PUSERINFO_T  User = NULL;
     
   sts = EssGetUserEx (hCtx, "Jim Smith", &User);
   if (!sts)
   {   
      if (User)
         EssFree (hInst, User);
   }
   return (sts);
}

See Also

EssGetApplicationAccess()
EssCreateExtUser
EssListUsers()
EssSetUser()
EssListUsersEx
EssSetUserEx()
ESS_USERINFOEX_T