(IN) Specifies the NetWare server connection handle containing the file.
dirHandle
(IN) Specifies the NetWare directory handle.
fileName
(IN) Points to the string containing a path name, relative to
dirHandle.
searchAttrs
(IN) Specifies the attributes to use in searching for a file.
newAttrs
(IN) Specifies the new attributes to be applied to the file designated
by dirHandle and pbstrFileName.
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x898C
N0_MODIFY_PRIVILEGES
0x898D
SOME_FILES_AFFECTED_IN_USE
0x898E
NO_FILES_AFFECTED_IN_USE
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
Failure, NO_FILES_FOUND_ERROR
Notices
dirHandle can be zero if fileName points to the
complete path, including the volume name.
fileName can specify either a file's complete path name or a
path relative to the current working directory. For example, if a
complete path name is SYS:ACCOUNT/DOMEST/TARGET.DAT and the
directory handle mapping is SYS:ACCOUNT, fileName
could point to either of the following:
SYS:ACCOUNT/DOMEST/TARGET.DAT or
DOMEST/TARGET.DAT
In the first example, where fileName points to the complete
path, dirHandle could be set to zero. If the directory handle
is 0, the file name must contain the full path, including the volume name.
searchAttrs includes system and/or hidden files. In other words,
if only the system bit is set in searchAttrs, 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), 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.