(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: