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:
[If this table is unreadable, a preformatted table follows]
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
[If this table is unreadable, a preformatted table follows]
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.