Click above to get retro games delivered to your door ever month!

 aofToggleRecord()
 Toggles whether the record is contained in a Client Advantage Optimized
 Filter
------------------------------------------------------------------------------

Syntax

     aofToggleRecord( <nHandle>, <nRecord> ) -> logical

     <nHandle>  Handle to an existing filter.

     <nRecord>  The record to change in the filter.

Returns

     Returns .T. if the operation was successful; .F. indicates it
     failed. If aofToggleRecord() failed, aofErrorCode() will return
     information on why the function failed.

Description

     aofToggleRecord() changes whether the specified record is contained
     in a user-owned or a system-owned filter. To change whether a record
     is contained in a system-owned filter using  aofToggleRecord(), you
     must first get a handle to that system-owned filter via the
     aofGetFilterHandle() function.

Example

     USE Customer VIA "DBFCDXAX"

     // Create an empty, user-owned optimized filter
     nHandle := aofCreateFilter()

     // Add records to the filter
     aofAddRecord( nHandle,  5 )
     aofAddRecord( nHandle, 10 )

     // Remove record 5 from the filter
     aofToggleRecord( nHandle, 5 )

     // Add record 25 to the filter
     aofToggleRecord( nHandle, 25 )

     // Free the user-owned filter
     aofFreeFilter( nHandle )