NWScanForDeletedFiles(3nw)


NWScanForDeletedFiles -- scans specified directory for deleted (salvageable) files

Synopsis

   #include <nwdel.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWScanForDeletedFiles (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnuint32 iterHandle, pnuint32 volNum, pnuint32 dirBase, NWDELETED_INFO N_FAR * entryInfo);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle of the directory to scan.

iterHandle
(IN) Points to the address of the search sequence number. Must be initially set to -1.

volNum
(OUT) Points to the volume's number index (valid for 3.11 and above only).

dirBase
(OUT) Points to the directory's number index (valid for 3.11 and above only).

entryInfo
(OUT) Points to NWDELETED_INFO, containing the deleted file information.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89FF
No more salvageable files in directory

Notices

NWScanForDeletedFiles replaces NWScanSalvageableFiles.

Initially, iterHandle needs to be set to -1. The server maintains the sequence number once a match has been found. No file names or wildcards are allowed in the search.

volNum and dirBase are used only when scanning NetWare 3.11 and above. These two numbers are indices used by the server to speed up the location of a deleted file. They should not be modified by an application.

Although parameters may only be valid for some servers, each parameter must be filled. The valid parameters for NWScanForDeletedFiles on each platform follow:

3.0 and 3.1 3.11
conn conn
dirHandle dirHandle
sequence iterHandle
volNum -
dirBase -
entryInfo entryInfo

 
 3.0 and 3.1   3.11 
 conn          conn 
 dirHandle     dirHandle 
 sequence      iterHandle 
 volNum        - 
 dirBase       - 
 entryInfo     entryInfo 

Services

Deleted File

NCP calls

0x2222 22 27 Scan Salvageable Files
0x2222 23 17 Get File Server Information
0x2222 87 16 Scan Salvageable Files

 
 0x2222   22   27   Scan 
                    Salvageable 
                    Files 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   87   16   Scan 
                    Salvageable 
                    Files 

References

NWPurgeDeletedFile(3nw), NWRecoverDeletedFile(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.