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

 FilArchiveTimeGet() / FilArchiveTimeSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the last archive time of a file.

 Syntax:
 lpszArcTime = FilArchiveTimeGet( lpszPath )
 lpszArcTime = FilArchiveTimeSet( lpszPath,

 lpszNewTime )

 Parameters:
 lpszPath    The full NetWare directory path of the file.
 lpszNewTime The new time.

 Returns:
 A character string of length 8.

 The CA-Clipper names for these functions are:
 FilArcTmeGet() / FilArcTmeSet()

 Description:
 FilArchiveTimeGet() returns the last time of day that the file specified
 by lpszPath was archived (backed up). lpszPath must be the full directory
 path, including the name of the file itself and the volume name,
 e.g.: SYS:DATA\KATIE\WP\JANE.DOC.

 FilArchiveTimeSet() sets the last archived date of the file to lpszNewTime
 and returns the previous value.

 Returns an empty string if an error occurs.

 Example:
 // To find the time of day that SYS:DATA\KATIE\WP\JANE.DOC was
 // last archived or backed up:

 lpszArcTime = FilArchiveTimeGet(
 "SYS:DATA\KATIE\WP\JANE.DOC" )
 if ( !empty( lpszArcTime ) )
    ? "SYS:DATA\KATIE\WP\JANE.DOC was last archived at ", lpszArcTime
 endif

 // To change the last archived time of file SYS:DATA\JANE.DOC to
 // 12:00:00:

 lpszOldtime = FilArchiveTimeSet( "SYS:DATA\JANE.DOC", "12:00:00" )
 lpszNewtime = FilArchiveTimeGet( "SYS:DATA\JANE.DOC" )
 if ( !empty( lpszNewtime ) )
    ? "SYS:DATA\JANE.DOC's last archived time was ", lpszOldtime
    ? "SYS:DATA\JANE.DOC's last archived time is now ", lpszNewtime
 endif

 Notes:
 The time is returned in the form HH:MM:SS.

 Appropriate trustee access rights are required to use these functions.