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

  m6_FiltRestore():

  Purpose:  Retrieves filter from a specified file.

   Syntax:  m6_FiltRestore( <cFileName> )

    Where:  <cFileName>   --  Filename to open and retrieve the filter
                              from.

  Returns:  A numeric handle to the restored filter.  A value of 0
            indicates the restoration failed.  In the case of a 0 handle
            call m6_Error() to retrieve the reason for the error.

  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()