NWAddTrustee(3nw)
NWAddTrustee --
adds a trustee to the list of trustees in a file or directory
Synopsis
#include <nwdentry.h>
or
#include <nwcalls.h>
NWCCODE N_API NWAddTrustee
(NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
pnstr8 path,
nuint32 objID,
nuint16 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.
- path
-
(IN) Points to the absolute path (or a path relative to the dirHandle) of the directory to which a trustee is being added.
- objID
-
(IN) Specifies the bindery object ID for the object being added as a trustee.
- rightsMask
-
(IN) Specifies the access rights mask being granted to the new trustee.
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
To modify a trustee rights list, the requesting workstation must have parental rights to the directory or to a parent of the directory.
dirHandle can be zero if path points to the complete path, 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 rightsMask.Otherwise, the object
is added as a trustee to the directory with rights equal to rightsMask.
NOTE:
2.x servers do not support file level trustee assignments. NWAddTrustee does not check whether the specified path is a file, or a directory path. The input parameters
are passed as is to the server, and the server returns an error for a file level input.
Services
File Systems
NCP calls
0x2222 23 17 Get File Server Information
0x2222 22 13 Add Trustee To Directory
0x2222 22 39 Add Extended Trustee To Directory Or File
0x2222 87 10 Add Trustee Set To File Or Subdirectory
References
NWAddTrusteeToDirectory(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.