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

  m6_GetAreaFilter():

  Purpose:  Gets a handle to a workarea filter so you can manipulate it
            with any of the RYO filter functions.

   Syntax:  m6_GetAreaFilter()

  Returns:  A handle to the workarea filter.  A handle of 0 indicates an error
            occurred or that no filter exists in this workarea.  To determine
            the exact reason for a failure call m6_Error().

     Note:  The system still retains ownership of the any filter handle
            returned by this function.

  Example:

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

         USE Customer via "SIXCDX"

         SET INDEX TO State

         //...........................................set optimizable filter
         SET FILTER TO State = 'CA'

         //............................................initalize the filter
         GO TOP

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

         //...............................add a couple records to the filter
         m6_FiltAddRec( nHandle, 10 )
         m6_FiltAddRec( nHandle, 20 )

         //..browse records in filter.  Note 10 and 20 will also be visible
         Browse()