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.