NWScanForDeletedFiles

Scans the specified directory for any deleted (salvageable) files

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Deleted File

Syntax

   #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);
   

Delphi Syntax

   uses calwin32 
    
   Function NWScanForDeletedFiles 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      iterHandle : pnuint32; 
      volNum : pnuint32; 
      dirBase : pnuint32; 
      Var entryInfo : NWDELETED_INFO 
   ) : NWCCODE;
   

Parameters

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

These are common return values; see Return Values for C for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x899B

BAD_DIRECTORY_HANDLE

0x89FF

No more salvageable files in directory

Remarks

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.

If iterHandle and entryInfo are NULL or dirHandle is zero, NWScanForDeletedFiles returns -1.

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

NCP Calls

See Also

NWPurgeDeletedFile, NWRecoverDeletedFile