nxAddTrustee

Adds a trustee to the trustee list for the specified file or directory.

Library:LibC
Classification:Novell®
Service:NetWare Platform

Syntax

  #include <nks/netware.h>
   
  int nxAddTrustee (
     NXPathCtx_t   pathCtx,
     const char   *pathname,
     uint32_t      objectID,
     uint32_t      rights );

Parameters

pathCtx

(IN) Specifies the file system path context. Along with the pathname parameter, it specifies the file or directory.

pathname

(IN) Points to a null-terminated Unicode or ASCII string that specifies the name of the file or directory (relative to pathCtx).

objectID

(IN) Specifies the ID of the user to add as a trustee

rights

(IN) Specifies a bit mask of the rights to grant to the trustee. For a list of possible values, see Effective Rights Flags in Volume 1. If the user is already a trustee in the specified directory or file, the existing rights mask for the trustee is replaced by the value in the rights parameter.

Return Values

If successful, returns 0. Otherwise returns a nonzero error code.

Decimal

Hex

Constant

Description

4

0x04

NX_EBADF

The pathCtx and pathname parameters do not refer to a valid file system object.

79

0x4F

NX_ENOTSUP

The specified file system object is on the DOS partition.

105

0x69

NX_ENOCONTEXT

No NKS context is present.

Remarks

You can use this function on traditional, NSS, and remote volumes, but it returns NX_ENOTSUP for the DOS partition.

This function specifies the directory or file by passing a pathname. The pathName parameter can identify an absolute or relative directory or file path. An absolute path includes a volume. For information on how pathCtx and pathname work together, see Path Contexts and File System Paths in Volume 1.

See Also