EssSetFilterList

Sets the list of groups or users that are assigned to a filter. The count parameter controls the number of groups or users assigned to the filter. A count of zero will remove all the groups or users from the list.

Syntax

ESS_FUNC_M  EssSetFilterList (hCtx, AppName, DbName, FilterName, Count, pUserList);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle
AppName	ESS_STR_T	Application name
DbName	ESS_STR_T	Database name
FilterName	ESS_STR_T	Filter name
Count	ESS_USHORT_T	Count of groups or users assigned this filter
pUserList	ESS_PUSERNAME_T	Pointer to array of user names

Return Value

None.

Access

This function requires the caller to have database Design privilege (ESS_PRIV_DBDESIGN) for the specified database.

Example

ESS_FUNC_M 
ESS_SetFilterList (ESS_HCTX_T  hCtx)        
{
   ESS_FUNC_M        sts = ESS_STS_NOERR;
   ESS_STR_T        AppName;   
   ESS_STR_T        DbName;
   ESS_STR_T        FilterName;
   ESS_USHORT_T     Count = 0;
   ESS_USERNAME_T   UserList[2];
   
   AppName    = "Sample";
   DbName     = "Basic";
   FilterName = "Test";
   strcpy(UserList[0],"Jim Smith");  
   strcpy(UserList[1],"Newuser");  
   Count = 2;
   
   sts = EssSetFilterList(hCtx, AppName, DbName,
         FilterName, Count, UserList);  
   return (sts);
}