NWPurgeDeletedFile(3nw)


NWPurgeDeletedFile -- removes recoverable files from NetWare server

Synopsis

   #include <nwdel.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWPurgeDeletedFile (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, nuint32 iterHandle, nuint32 volNum, nuint32 dirBase, pnstr8 fileName);

Description

The parameters are as follows:

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

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8985
NO_CREATE_DELETE_PRIVILEGES

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

Notices

For 2.x servers, all salvageable files on all volumes of the specified NetWare server are purged. 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:

2.x 3.0 and 3.1 3.11
conn conn conn
dirHandle dirHandle -
sequence iterHandle -
volNum - -
dirBase - -
fileName - -

 
 ------------------------------------------------ 
| 2.x      |  3.0 and 3.1|  3.11                | 
|----------|-------------|----------------------| 
| conn     |  conn       |  conn                | 
|----------|-------------|----------------------| 
| dirHandle|  dirHandle  |  -                   | 
|----------|-------------|----------------------| 
| sequence |  iterHandle |  -                   | 
|----------|-------------|----------------------| 
| volNum   |  -          |  -                   | 
|----------|-------------|----------------------| 
| dirBase  |  -          |  -                   | 
|----------|-------------|----------------------| 
| fileName |  -          |  -                   | 
|----------|-------------|----------------------| 

Services

Deleted File

NCP calls

0x2222 22 16 Purge Deleted File
0x2222 23 17 Get File Server Information
0x2222 87 18 Purge Salvageable File
0x2222 22 29 Purge Salvageable File

 
 ----------------------------------------- 
| 0x2222|  22|  16|  Purge Deleted File  | 
|-------|----|----|----------------------| 
| 0x2222|  23|  17|  Get File Server     | 
|       |    |    |  Information         | 
|-------|----|----|----------------------| 
| 0x2222|  87|  18|  Purge Salvageable   | 
|       |    |    |  File                | 
|-------|----|----|----------------------| 
| 0x2222|  22|  29|  Purge Salvageable   | 
|       |    |    |  File                | 
|-------|----|----|----------------------| 

References

NWScanForDeletedFiles(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.