NWAddTrusteeToDirectory(3nw)


NWAddTrusteeToDirectory -- adds a trustee to the trustee list in a directory

Synopsis

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

NWCCODE N_API NWAddTrusteeToDirectory (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint32 trusteeID, nuint8 rightsMask);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the desired directory path (0 if path includes the volume name).

path
(IN) Points to the absolute path (or a path relative to the directory handle) of the directory to which a trustee is being added.

trusteeID
(IN) Specifies the bindery object ID for the object being added as a trustee.

rightsMask
(IN) Specifies the access rights mask the new trustee is being granted.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x898C
NO_MODIFY_PRIVILEGES

0x8990
NO_FILES_AFFECTED_READ_ONLY

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x8999
DIRECTORY_FULL

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89A1
DIRECTORY_IO_ERROR

0x89FC
NO_SUCH_OBJECT

0x89FD
BAD_STATION_NUMBER

0x89FF
HARDWARE_FAILURE

Notices

dirHandle can be zero if path points to the complete path of the new directory, including the volume name.

If the object is already a trustee for the specified directory, the trustee's current access mask is replaced by the value contained in trusteeID. Otherwise, the object is added as a trustee to the directory and given a rights mask equal to trusteeID.

To modify a trustee rights list, the requesting workstation must have parental rights to the directory or to a parent of the directory.

The object must be static. If the object is dynamic, NWAddTrusteeToDirectory returns an error.

Services

File Systems

NCP calls

0x2222 22 13 Add Trustee To Directory
0x2222 22 39 Trustee Add Ext
0x2222 23 17 Get File Server Information
0x2222 87 10 Add Trustee Set To File Or Subdirectory

References

NWAddTrustee(3nw),


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