Gets the next row of a filter.
Syntax
ESS_FUNC_M EssGetFilterRow (hCtx, pRowString, pAccess);
| Parameter | Data Type | Description |
|---|---|---|
hCtx | ESS_HCTX_T | API context handle. |
pRowString | ESS_PSTR_T | Address of pointer to receive the next row of the filter. |
pAccess | ESS_PACCESS_T | Address of variable to receive the access level for the filter row. Possible values are listed in Bitmask Data Types (C). |
Notes
This function should be called repeatedly after calling EssGetFilter(), until a NULL row string pointer is returned.
The memory allocated for pRowString should be freed using EssFree().
Return Value
If successful, returns the next filter row (if any) in pRowString, and the row access level in pAccess.
Access
This function requires the caller to have database designer privilege (ESS_PRIV_DBDESIGN) for the specified database.
Example
See the example of EssGetFilter.
See Also