AdsRefreshAOF

Re-evaluates the active Advantage Optimized Filter against current data.

Syntax

UNSIGNED32 AdsRefreshAOF(ADSHANDLE hTable);

Parameters

Parameter	Type	Description
`hTable`	`ADSHANDLE`	Handle of the table with an active AOF.

Return Value

AE_SUCCESS (0) on success, including when no AOF is active (no-op). AE_INTERNAL_ERROR (5000) for an unknown handle.

Description

AdsRefreshAOF re-evaluates the AOF expression installed by AdsSetAOF against the table’s current contents and reinstalls the resulting bitmap. Records that were appended or whose key fields changed since the filter was set are re-classified, so the visible set reflects the latest data.

If no AOF is active, or the set was built only via AdsCustomizeAOF (no stored expression), the call succeeds without changing anything. For remote tables the server maintains the AOF, so the call is a no-op.

Example

AdsSetAOF(hTable, "BALANCE > 0", 0);
// ... records change or are appended ...
AdsRefreshAOF(hTable);   // visible set now reflects the new data