NWAFPDelete(3nw)


NWAFPDelete -- deletes an AFP file or directory

Synopsis

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

NWCCODE NWAPI NWAFPDelete (NWCONN_HANDLE conn nuint16 volNum, nuint32 AFPEntryID, pnstr8 AFPPathString);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

volNum
(IN) Specifies the volume number of the directory entry location.

AFPEntryID
(IN) Specifies the AFP base ID.

AFPPathString
(IN) Points to the AFP directory path relative to AFPEntryID.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8805
NET_RECV_ERROR

0x8983
IO_ERROR_NETWORK_DISK

0x8988
INVALID_FILE_HANDLE

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

0x8993
NO_READ_PRIVILEGES

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
Bad AFP Entry ID

0x899C
INVALID_PATH

0x899E
INVALID_FILENAME

0x899F
DIRECTORY_ACTIVE

0x89A0
DIRECTORY_NOT_EMPTY

0x89A1
DIRECTORY_IO_ERROR

0x89A2
READ_FILE_WITH_RECORD_LOCKED

0x89FD
BAD_STATION_NUMBER

0x89FF
NO_FILES_FOUND_ERROR

0x89FF
File Exists Error

Notices

The directories to be deleted must be empty. Files to be deleted must be closed by all users.

For AFPPathString, byte 0 must be the length of the file name. The file name begins at byte 1 of the string. Include only the file name---not the full path name---when calling NWAFPDelete.

Services

AppleTalk Filing Protocol

NCP calls

0x2222 35 03 AFP Delete

References

NWAFPCreateDirectory(3nw), NWAFPCreateFile(3nw), NWAFPGetEntryIDFromName(3nw), NWAFPGetEntryIDFromHandle(3nw), NWAFPGetEntryIDFromPathName(3nw),


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