Adds a trustee to the list of trustees in a file or directory, using UTF-8 strings.
#include <nwdentry.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY(NWCCODE)NWAddTrusteeExt (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
const nstr8 N_FAR *path,
nuint32 objID,
nuint16 rightsMask);
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the desired directory path (0 if the path parameter contains the complete path, including the volume name).
(IN) Points to the absolute path (or a path relative to the dirHandle parameter) of the directory to which a trustee is being added. The characters in the string must be UTF-8.
(IN) Specifies the object ID for the object being added as a trustee.
(IN) Specifies the access rights mask being granted to the new trustee. For possible values, see Trustee Rights
These are common return values; see Return Values (Return Values for C) for more information.
To modify a trustee rights list, the requesting workstation must have access control rights to the directory or to a parent of the directory.
If the object is already a trustee for the specified directory, the current access mask of the trustee is replaced by the value contained in the rightsMask parameter. Otherwise, the object is added as a trustee to the directory with rights equal to the rightsMask parameter.