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

 FSFilPurge()
------------------------------------------------------------------------------
 Purpose:
 Purge erased files from the file server.

 Syntax:
 bResult = FSFilPurge( lpszPath, bAll )

 Parameters:
 lpszPath The directory from which to purge files (NetWare 386 only).
 bAll     The purge all flag.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 FSFilPurge() acts differently under NetWare 2.x and NetWare 3.x and above.

 NetWare 2.x

 FSFilPurge() returns TRUE if the erased files of the workstation are
 successfully purged. Returns FALSE if not, or if an error occurs.
 If bAll is set to TRUE, all erased files on the file server are purged.
 FSFilPurge("",TRUE) returns TRUE if all erased files on the default or
 preferred file server are successfully purged. Parameter lpszPath is
 ignored. Returns FALSE if not, or if an error occurs.

 NetWare 3.x and above

 lpszPath is the full directory path including volume name of the directory
 to be purged, e.g. SYS:DATA\WP. The directory name must be specified.
 FSFilPurge() returns TRUE if all the files in the specified directory have
 been purged successfully, or FALSE if an error has occurred.

 Example:
 // To purge the erased files of the workstation on a NetWare
 // 286 file server:

 if ( FSFilPurge("", FALSE) )
    ? "All erased files have been purged from the workstation"
 endif

 // To purge all erased files from a NetWare 286 file server:

 if ( FSFilPurge( "", TRUE ) )
    ? "All erased files for all workstations purged"
 endif

 // To purge all erased files from directory SYS:KATIE on a NetWare 386
 // file server:

 if ( FSFilPurge( "SYS:KATIE", FALSE ) )
    ? "All erased files in directory SYS:KATIE have been purged"
 endif

 Notes:
 Erased files which have been purged cannot be recovered using the
 NetWare SALVAGE command line utility. FSFilPurge("", TRUE) requires that
 the requesting user is logged in as console operator or is security
 equivalent to console operator.

 If FALSE is returned in either case, check NWErrorGet().