NWAddTrusteeToNSDirectory

Adds a trustee to the trustee list in a directory for the specified name space.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:File System

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE NWAddTrusteeToNSDrectory ( 
      NWCONN_HANDLE       conn,  
      nuint8              namSpc, 
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint32             trusteeID,  
      nuint8              rightsMask);
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

namSpc

(IN) Specifies the name space for the resulting trustee (see Section 20.5, Name Space Flag Values).

dirHandle

(IN) Specifies the directory handle associated with the desired directory path under the specified name space (0 if path contains the complete path, including the volume name).

path

(IN) Points to the absolute path (or a path relative to the directory handle) of the directory to which a trustee is being added.

trusteeID

(IN) Specifies the object ID for the object being added as a trustee.

rightsMask

(IN) Specifies the access rights mask the new trustee is being granted (see Trustee Rights).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_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

Remarks

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 trusteeID parameter. Otherwise, the object is added as a trustee to the directory and given a rights mask equal to the trusteeID parameter.

If you are using an NDS object name as the trustee name, call NWDSMapNameToID to return the value to pass to trusteeID.

To modify a trustee rights list, the requesting workstation must have access control rights to the directory or to a parent of the directory.

The object must be static. If the object is dynamic, NWAddTrusteeToNSDirectory will return an error.

NCP Calls

See Also

NWAddTrustee, NWAddTrusteeToDirectory, NWDeleteTrustee, NWDeleteTrusteeFromDirectory, NWDeleteTrusteeFromNSDirectory, NWScanNSDirectoryForTrustees