DeleteTrustee

Removes a trustee from a directory’s or file’s trustee list

Local Servers:blocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
SMP Aware:No
Service:File System

Syntax

   #include <nwdir.h> 
    
    int DeleteTrustee (  
       char   *pathName, 
       LONG    trusteeObjectID);
   

Parameters

pathName

(IN) Specifies the string containing path specification (maximum 255 characters, including the NULL terminator).

trusteeObjectID

(IN) Specifies the unique object ID of trustee.

Return Values

Value

Hex

Constant

0

(0x00)

ESUCCESS

152

(0x98)

ERR_VOLUME_DOES_NOT_EXIST

156

(0x9C)

ERR_INVALID_PATH

Remarks

The DeleteTrustee function revokes all of the rights that a trustee has been granted. This function specifies the trustee by passing the trustee’s object ID. The function identifies the directory or file by optionally passing a complete pathname or a partial pathname relative to the current working directory (CWD). In order to delete a trustee, the current connection must have access control rights to the directory or file.

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. Examples of absolute pathnames would be:

volume:directory\...\directory\filename

 

volume:filename

 

volume:

(equivalent to volume:\)

Applications might use a relative file path to specify a directory or file. The relative path, combined with the CWD specifies an absolute file path. For example, if the CWD points to SYS:\ and the specified pathname is PUBLIC\WORDP or PUBLIC\WORDP\ABC.TXT, then in the former case, the resulting directory is SYS:PUBLIC\WORDP and in the latter case, SYS:PUBLIC\WORDP\ABC.TXT.

The application can obtain an object’s ID by using NWDSMapNameToID or ScanTrustees .

SetCurrentNameSpace sets the name space which is used for parsing the path input to this function.

NOTE:For NetWare versions before 4.x, this function only works with DOS name space for remote servers.

See Also

AddTrustee, NWDSMapNameToID, ScanTrustees