EssCreateGroup

Creates a new group.

Syntax

ESS_FUNC_M EssCreateGroup (hCtx, GroupName);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
GroupName	ESS_STR_T	Name of group to create. See Group Name Limits.

Notes

The specified group must not already exist.
The group's access level may be set with the EssSetGroup() function.

Return Value

None.

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_CreateGroup (ESS_HCTX_T  hCtx)
{
   ESS_FUNC_M     sts = ESS_STS_NOERR;
   ESS_STR_T     GroupName;
   GroupName = "PowerUsers";
   
   sts = EssCreateGroup (hCtx, GroupName);
      
   return (sts);
}