NWSetDirEntryInfo(3nw)


NWSetDirEntryInfo -- changes information about directory entry

Synopsis

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

NWCCODE N_API NWSetDirEntryInfo (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, nuint8 searchAttrs, nuint32 iterHandle, nuint32 changeBits, NWENTRY_INFO N_FAR * newEntryInfo);

Description

The parameters are as follows:

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


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.

Services

File Systems

NCP calls

0x2222 22 37 Set Directory Entry Information
0x2222 23 17 Get File Server Information
0x2222 87 07 Modify File Or Subdirectory DOS Information

 
 0x2222   22   37   Set Directory 
                    Entry 
                    Information 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   87   07   Modify File Or 
                    Subdirectory 
                    DOS Information 

References

NWSetNSEntryDOSInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.