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); }
See Also