NWPurgeDeletedFile

Removes recoverable files from a 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 NWPurgeDeletedFile ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      nuint32             iterHandle,  
      nuint32             volNum,  
      nuint32             dirBase,  
      const nstr8 N_FAR  *fileName);

Delphi Syntax

   uses calwin32 
    
   Function NWPurgeDeletedFile 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      iterHandle : nuint32; 
      volNum : nuint32; 
      dirBase : nuint32; 
      fileName : pnstr8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle to purge.

dirHandle

(IN) Specifies the directory handle for the directory containing the file to purge (valid for 3.x and above only).

iterHandle

(IN) Specifies the sequence number returned by NWScanForDeletedFiles (valid for 3.x and above only).

volNum

(IN) Specifies the volume number returned by NWScanForDeletedFiles (valid for 3.11 and above only).

dirBase

(IN) Specifies the directory base number returned by NWScanForDeletedFiles (valid for 3.11 and above only).

fileName

(IN) Points to the name of the file to purge (valid for 3.0 and 3.1 only).

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8985

NO_CREATE_DELETE_PRIVILEGES

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

Remarks

For 3.x servers, only the specified file is purged.

For 3.x servers, NWPurgeDeletedFile is used in connection with NWScanForDeletedFiles. iterHandle, volNum, and dirBase are returned by NWScanForDeletedFiles and should not be modified prior to calling NWPurgeDeletedFile.

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

3.0 and 3.1

3.11

conn

conn

dirHandle

dirHandle

sequence

iterHandle

 

volNum

 

dirBase

fileName

 

NCP Calls

See Also

NWScanForDeletedFiles