(IN) Specifies the NetWare server connection handle.
dirHandle
(IN) Specifies the directory handle. For files, dirHandle must
point to parent directory. For directories, it should follow the same
conventions as for NWScanDirEntryInfo.
searchAttrs
(IN) Specifies the earch attribute to use in searching for the directory entry.
iterHandle
(IN) Currently unused; can be ignored.
changeBits
(IN) Specifies the set of bits to indicate which attributes to change.
newEntryInfo
(IN) Points to NWENTRY_INFO.
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x8998
VOLUME_DOES_NOT_EXIST
0x899B
BAD_DIRECTORY_HANDLE
0x899C
INVALID_PATH
Notices
NWSetDirEntryInfo only works with 3.11 and above servers.
searchAttrs specifies the kind of entry to look for (hidden,
system, etc.). For example:
If only the system bit is set in searchAttrs, all files except
hidden files are affected.
If only the hidden bit is set, all files except system files are affected.
If neither bit is set (0x00), only files not designated either hidden or
system are affected.
NOTE:
A file is designated hidden or system if its corresponding file attribute
is set.
searchAttrs may be defined as any of the following:
0x00
FA_NORMAL
0x02
FA_HIDDEN
0x04
FA_SYSTEM
0x10
FA_DIRECTORY
changeBits bit definition is as follows:
0x0001L
MModifyNameBit
0x0002L
MFileAttributesBit
0x0004L
MCreateDateBit
0x0008L
MCreateTimeBit
0x0010L
MOwnerIDBit
0x0020L
MLastArchivedDateBit
0x0040L
MLastArchivedTimeBit
0x0080L
MLastArchivedIDBit
0x0100L
MLastUpdatedDateBit
0x0200L
MLastUpdatedTimeBit
0x0400L
MLastUpdatedIDBit
0x0800L
MLastAccessedDateBit
0x1000L
MInheritedRightsMaskBit
0x2000L
MMaximumSpaceBit
NWENTRY_INFO must be initialized to 0 before calling
NWScanDirEntryInfo.
To change a directory's information, the requesting workstation must
have access control and modify rights. Only SUPERVISOR can
change the owner of a directory. The directory's
lastModifyDateAndTime in NWDIR_INFO cannot be changed
for volumes. An attempt to do so sets the last modified date and time to
the current date and time.
For files, dirHandle must point to the parent directory and
nameLength and name in NWENTRY_INFO must
contain the specific file information.
For directories, if dirHandle points to the parent directory,
nameLength and name in NWENTRY_INFO must
contain the specific directory information.
For directories, if dirHandle points to the specific directory
itself, nameLength must be set to 0.
For each name space, dirHandle, nameSpace,
name and nameLength must be synchronized to indicate
the correct name space. For example, if Mac O/S is used,
dirHandle, nameSpace and nameLength must
reflect a Mac O/S directory handle, a Mac O/S name
space, a Mac O/S file or directory name, and the length of the
Mac O/S file or directory name.