NWScanForDeletedFilesExt

Scans the specified directory for any deleted (salvageable) files, using UTF-8 strings.

Local Servers:blocking

Remote Servers:blocking

NetWare Server:6.5 SP2 or later

Platform:NLM, Windows 2000, Windows XP

Client:4.90 SP2 or later

Library:Cross-Platform NetWare Calls (CAL*.*)

Service:Deleted File

Syntax

   #include <nwdel.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWScanForDeletedFilesExt ( 
      NWCONN_HANDLE               conn,  
      NWDIR_HANDLE                dirHandle,  
      pnuint32                    iterHandle,  
      pnuint32                    volNum,  
      pnuint32                    dirBase,  
      NWDELETED_INFO_EXT  N_FAR  *entryInfo);

Parameters

conn: (IN) Specifies the NetWare server connection handle.
dirHandle: (IN) Specifies the directory handle of the directory to scan. This parameter cannot be zero.
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.
dirBase: (OUT) Points to the directory’s number index.
entryInfo: (OUT) Points to NWDELETED_INFO_EXT, 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
0x88F0	UTF8_CONVERSION_FAILED
0x890A	NLM_INVALID_CONNECTION
0x899B	BAD_DIRECTORY_HANDLE
0x89FF	No more salvageable files in directory

Remarks

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, NWScanForDeletedFilesExt returns -1.

volNum and dirBase are indices used by the server to speed up the location of a deleted file. They should not be modified by an application.

NCP Calls