NWRecoverDeletedFile

Recovers deleted files from the NetWare server

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 NWRecoverDeletedFile ( 
      NWCONN_HANDLE   conn,  
      NWDIR_HANDLE    dirHandle,  
      nuint32         iterHandle,  
      nuint32         volNum,  
      nuint32         dirBase,  
      pnstr8          delFileName,  
      pnstr8          rcvrFileName);

Delphi Syntax

   uses calwin32 
    
   Function NWRecoverDeletedFile 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      iterHandle : nuint32; 
      volNum : nuint32; 
      dirBase : nuint32; 
      delFileName : pnstr8; 
      rcvrFileName : pnstr8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle containing the deleted file.

dirHandle

(IN) Specifies the directory handle of the directory containing the file to recover.

iterHandle

(IN) Specifies the number returned by NWScanForDeletedFiles.

volNum

(IN) Specifies the number returned by NWScanForDeletedFiles.

dirBase

(IN) Specifies the number returned by NWScanForDeletedFiles.

delFileName

(OUT) Points to the name of the erased file.

rcvrFileName

(OUT) Points to the name to use in recovering the file.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x8984

NO_CREATE_PRIVILEGES

0x8996

SERVER_OUT_OF_MEMORY

0x89A1

DIRECTORY_IO_ERROR

0x89FD

BAD_STATION_NUMBER

0x89FE

File name already exists in this directory

0x89FF

Failure

Remarks

For 3.x-6.x servers, files deleted by a client are moved to a holding area on the volume until they are either purged, restored (by calling NWRecoverDeletedFile), or replaced by other deleted files.

For 3.11 servers, the recovery is performed one file at a time. NWRecoverDeletedFile can also recover the deleted file and give it a new name. This feature alleviates problems with recovering a file when a new file exists with the same name.

For 3.x, the application must specify the file name in rcvrFileName, not the path. No wildcards are allowed.

NOTE:Due to earlier support for 14 character names in NetWare, both delFileName and rcvrFileName buffers must be at least 15 bytes long.

Although parameters may only be valid for some servers, each parameter must be filled. Valid parameters for NWRecoverDeletedFile on each platform are listed below:

3.0 and 3.1

3.11 and above

conn

conn

dirHandle

dirHandle

sequence

iterHandle

 

volNum

 

dirBase

deletedFileName (passed in)

 

recoverFileName (passed in)

rcvrFileName

NCP Calls

See Also

NWScanForDeletedFiles