zGetTrustee

Reads all the trustees assigned to a file.

Service:File System Services (64-Bit)

Version:OES 2

Syntax

#include <zPublics.h>

STATUS zGetTrustee(
   Key_t    key,
   NINT     startingIndex,
   GUID_t  *retTrustee,
   NINT    *retRights,
   NINT    *retNextIndex);

Parameters

key: (IN) Specifies the file object (as returned by zOpen or zCreate) whose trustees will be retrieved.
startingIndex: (IN) Specifies the starting index for reading the next set of trustees. Zero specifies to begin reading the trustees. Thereafter, it should be replaced by the index returned by retNextIndex.
retTrustee: (IN/OUT) Points to the buffer to return the trustee assigned to this file that corresponds to startIndex.
retRights: (OUT) Points to the rights associated with the returned trustee.
retNextIndex: (OUT) Points to the next index to be used in startingIndex. If this is set to negative one, all the trustees have been read.

Return Values

zOK	The operation completed successfully.
non-0	An error occurred (see Section 4.1, Return Values for a description).

Remarks

zGetTrustee returns only the trustees assigned to a file that you are allowed to see. The index does not imply any order to the trustees. Instead, it is a simple way to keep track of where to begin again in the list of trustees. Only one trustee is returned at a time.