NWDeleteNSEntry

Erases the specified files from the 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:Name Space

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWDeleteNSEntry ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *fileName,  
      nuint8              nameSpace,  
      nuint16             searchAttr);
   

Delphi Syntax

   uses calwin32 
    
   Function NWDeleteNSEntry 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const fileName : pnstr8; 
      nameSpace : nuint8; 
      searchAttr : nuint16 
   ) : NWCCODE;
   

Parameters

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 exceed 255 characters in length.

nameSpace

(IN) Specifies the name space of dirHandle/filePath (see Section 20.5, Name Space Flag Values).

searchAttr

(IN) Specifies the file attributes to use in finding the file (see Section 20.8, Search Attributes Values).

Return Values

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

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

Remarks

dirHandle must exist in the designated name space.

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

NCP Calls

See Also

NWIntEraseFiles, NWOpenCreateNSEntry, NWRecoverDeletedFile