NWIntEraseFiles(3nw)


NWIntEraseFiles -- deletes NetWare files from the server

Synopsis

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

NWCCODE N_API NWIntEraseFiles (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 searchAttrs, nuint16 augmentFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle containing the file to erase.

dirHandle
(IN) Specifies the directory handle of the file to be erased.

path
(IN) Points to the string containing the file path, including file name, of the file to be erased.

searchAttrs
(IN) Specifies the search attributes.

augmentFlag
(IN) Specifies if wildcards are augmented:

0 = wildcards are not augmented
non-zero = all wildcards are augmented

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x898A
NO_DELETE_PRIVIEGES

0x898D
SOME_FILES_AFFECTED_IN_USE

0x898E
NO_FILES_AFFECTED_IN_USE

0x898F
SOME_FILES_AFFECTED_READ_ONLY

0x8990
NO_FILES_AFFECTED_READ_ONLY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89FF
NO_FILES_FOUND_ERROR

Notices

NWIntEraseFiles is replacing NWEraseFiles.

dirHandle can be zero if path points to the complete path, including the volume name.

searchAttrs includes system and/or hidden files. In other words, if only the system bit is set in searchAttrs, then all files are affected except hidden files. If only the hidden bit is set, all files are affected except system files. When neither bit is set (0x00), then only files that are not designated either hidden or system are affected.


NOTE: A file is designated hidden or system if its corresponding file attribute is set.

Search attributes to use in finding a file follow:

   0x00   none 
   0x02   FA_HIDDEN 
   0x04   FA_SYSTEM 
   0x06   both 

path can specify either a file's complete path name or a path relative to the current working directory. For example, if a file's complete path name is SYS:ACCOUNT/DOMEST/TARGET.DAT and the directory handle mapping is SYS:ACCOUNT, the value of path could be either of the following:

   SYS:ACCOUNT/DOMEST/TARGET.DAT 
or
   DOMEST/TARGET.DAT 
path can point to wildcards in the file name only. Wildcard matching uses the method defined by the application when it passes a wildcard character.

The client must have file deletion privileges in the target directory or this call will fail.

If a file has the immediate puge attribute set, the file cannot be recovered.

Services

File Systems

NCP calls

0x2222 23 17
Get File Server Information

0x2222 68
Erase File

0x2222 87 08
Delete A File Or Subdirectory

References

NWPurgeDeletedFile(3nw), NWPurgeErasedFiles(3nw), NWRecoverDeletedFile(3nw), NWRenameFile(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.