nxScanTrustees

Scans the specified directory or file for trustee assignments.

Library:LibC
Classification:Novell
Service:NetWare Platform

Syntax

  #include <nks/netware.h>
   
  int nxScanTrustees (
     NXPathCtx_t     pathCtx,
     const char     *pathname,
     uint32_t        sequence,
     uint32_t       *count,
     nxTrustees_t   *trusteeVector,
     uint32_t       *nextSequence );

Parameters

pathCtx

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

pathname

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

sequence

(IN) Specifies where to begin the scan. On the first scan, set this to 0.

count

(IN/OUT) Points to the maximum number of trustee structures the trusteeVector can hold. On return, points to the number of structures in the array.

trusteeVector

(OUT) Points to an array of structures containing the trustees of the scanned directory or file.

nextSequence

(OUT) Points to the value to use for the sequence parameter in the next scan.

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.

9

0x09

NX_EINVAL

The count parameter is set to 0.

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 iteratively to scan a directory or file and return information about all the trustees.

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

For information on how pathCtx and pathname work together, see Path Contexts and File System Paths in Volume 1.

See Also