NWDeleteNSEntry(3nw)


NWDeleteNSEntry -- erases the specified files from the file server

Synopsis

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

NWCCODE N_API NWDeleteNSEntry (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 fileName, nuint8 nameSpace, nuint16 searchAttr);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare connection handle.

dirHandle
(IN) Specifies the directory handle on which files to be deleted currently reside.

fileName
(IN) Points to an absolute path (or relative if dirHandle is non-zero) that cannot cannot exceed 255 characters in length.

nameSpace
(IN) Specifies the name space of dirHandle/filePath.

searchAttr
(IN) Specifies the file attributes to use in finding the file.

Return values

0x0000
SUCCESSFUL

0x898A
NO_DELETE_PRIVILEGES

0x898D
SOME_FILES_AFFECTED_IN_USE

0x898E
NO_FILES_AFFECTED_IN_USE

0x898F
SOME_FILES_AFFECTED_READ_ONLY

0x8990
NO_FILES_AFFECTED_READ_ONLY

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89A1
DIRECTORY_IO_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
NO_FILES_FOUND_ERROR

Notices

dirHandle must exist in the designated name space.

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

Services

Name Space

NCP calls

0x2222 68 Erase File
0x2222 87 08 Delete A File Or Subdirectory

References

NWIntEraseFiles(3nw), NWOpenCreateNSEntry(3nw), NWPurgeErasedFiles(3nw), NWRecoverDeletedFile(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.