NWRecoverDeletedFileExt

Recovers deleted files from the NetWare server, 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 NWRecoverDeletedFileExt ( 
      NWCONN_HANDLE   conn,  
      NWDIR_HANDLE    dirHandle,  
      nuint32         iterHandle,  
      nuint32         volNum,  
      nuint32         dirBase,  
      pnstr8          delFileName,  
      pnstr8          rcvrFileName);

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 NWScanForDeletedFilesExt.
volNum: (IN) Specifies the number returned by NWScanForDeletedFilesExt.
dirBase: (IN) Specifies the number returned by NWScanForDeletedFilesExt.
delFileName: (OUT) Points to the name of the erased file, using UTF-8 characters.
rcvrFileName: (OUT) Points to the name to use in recovering the file, using UTF-8 characters.

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
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

Files deleted by a client are moved to a holding area on the volume until they are either purged, restored (by calling NWRecoverDeletedFileExt), or replaced by other deleted files.

NWRecoverDeletedFileExt can 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. The application must specify the file name in rcvrFileName, not the path. No wildcards are allowed.

NCP Calls