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

  m6_FiltSave():

  Purpose:  Saves filter to a specified file.

   Syntax:  m6_FiltSave( <nHandle>, <cFileName> )

    Where:  <nHandle>     --  Is any valid handle to a filter.

            <cFileName>   --  File name to store the filter in.

  Returns:  Logical value:  .T. means the operation was successful,  .F.
            indicates it failed.  In the case of a .F. value call m6_Error()
            to retrieve the reason for the error.

     Note:  This function is useful when you want to archive the status
            of a filter for future filter operations.

  Example:

         #include "SIXCDX.CH"
         #include "MACHSIX.CH"

         //..............................................open customer file
         USE Customer via "SIXCDX"

         //.......................................open indexes to query on
         SET INDEX TO State, Age

         //......................................................set filter
         SET FILTER TO State="CA"

         //...................................get handle to workarea filter
         nHandle := m6_GetAreaFilter()

         //......................................save filter for posterity
         m6_FiltSave( nHandle, "Save.flt")

         //......................re-open Customer but without any indexes
         USE Customer

         //...........................................restore the filter
         nHandle := m6_FiltRestore( "Save.flt")

         //..................................SET FILTER TO my RYO filter
         m6_SetAreaFilter( nHandle )

         //........Browse records.  Only records in "CA" will be visible
         Browse()