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

 C_FILEWIPE()

 DESCRIPTION

 C_FILEWIPE() destroys the contents of a given file and erases it so
 that the file is unreadable even if recovered with disk utility
 programs.  C_FILEWIPE() destroys a file by writing ASCII 48 (zero)
 to each byte in the file, thus overwriting the original contents of
 the file.  It then changes the file's original name and finally
 deletes it.

 SYNTAX

 C_FILEWIPE(filename [,network])

 PARAMETERS

 filename (C) is the name of the file to destroy.  The complete file
 name including drive and path can be specified.  If a drive and
 path are not given, the file is assumed to be in the current
 directory.  Note that the file must be closed before calling this
 function.

 network (L) indicates whether or not the program is running on a
 network.  If the program is running on a network pass true (.T.) so
 the file can be opened with the proper share access, otherwise pass
 false (.F.).  If network is not specified, the default of false (.F.)
 is used.

 RETURNS

 C_FILEWIPE() returns a code indicating the status.  The return
 codes are as follows:

 RETURN CODE          DESCRIPTION
 -----------          -----------
 0                    Successful wipe and delete
 1                    File not found
 2                    Can not allocate memory

 EXAMPLES

 c_filewipe("TEST.TXT")     && destroys contents of file and deletes it