Scans the specified directory for information about deleted (salvageable) files.
#include <fsio.h>
int scanerasedfiles (
const char *path,
long *nextEntryNumber,
NWDIR *deletedFileInfo );
(IN) Points to the string containing the path specification of the directory to view.
(IN/OUT) Points to the entry number of the next file (initially set this to -1). This number uniquely identifies the file or directory, and is used to salvage the entry, to purge the entry, or to continue the scan.
(OUT) Points to a structure containing information about the entry.
If successful, returns 0. Otherwise, returns -1 and sets errno.
The scanerasedfiles function can be called repeatedly to obtain the list of deleted entries contained in the directory specified by the pathname parameter. Entries marked for deletion can be scanned to obtain information about who deleted them and when they were deleted.
On NSS volumes, both deleted files and directories are returned. Once a directory is salvaged, it can be scanned to show its deleted files and directories. On traditional volumes, only files are returned. Once a directory is removed, any deleted files are moved to the DELETED.SAV directory off the root of the volume. This directory can be scanned and the files salvaged or purged. The deleted directory structure cannot be recovered.
The path parameter can be an absolute path with a volume name or it can be relative to the current working directory. In the following example of a path, the erased files in the DIR1 directory on the SYS volume are scanned:
SYS:\DIR1
The caller must have See File rights in the specified directory.