NWDeleteTrustee

Removes a trustee from the specified directory or a trustee list for a file

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 <nwdentry.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWDeleteTrustee ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *dirPath,  
      nuint32             objID);
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the NetWare directory handle for the directory whose trustee list is being deleted (0 if the dirPath parameter points to the complete path, including the volume name).

dirPath

(IN) Points to the directory from which the trustee is being removed.

objID

(IN) Specifies the object ID for the trustee being deleted.

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

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

0x89FE

TRUSTEE_NOT_FOUND

0x89FF

HARDWARE_FAILURE, Failure

Remarks

NWDeleteTrustee also revokes the rights of the trustee in the specified directory.

To delete a trustee, the requesting workstation must have access control rights in the directory or in a parent directory.

Deleting the explicit assignment of an trustee object in a directory is not the same as assigning no rights to the object in the directory. If no rights are assigned in a directory, the object inherits the same rights as the parent directory.

NCP Calls

See Also

NWAddTrustee, NWDeleteTrusteeExt, NWIntScanForTrustees, NWScanNSDirectoryForTrustees, NWParseNetWarePath