revokeAccess (Database - Java™)

Removes a person, group, or server from a database access control list. This resets the access level for that person, group, or server to the Default setting for the database.

Note: Using this method at the same time an ACL object is in use may produce inconsistent results.

Defined in

Database

Syntax

public void revokeAccess(String name)
    throws NotesException

Parameters

String name

The name of the person, group, or server whose access you want to revoke. For a hierarchical name, the full name must be specified but can be in abbreviated format.

Usage

Revoking access is different than assigning No Access (which you can do with the grantAccess method). When you revoke access, you remove the name from the ACL, but the person, group, or server can still access the database at the level specified for Default. When you use the grantAccess method to assign No Access, the name remains in the ACL, and the person, group, or server cannot access the database, regardless of the Default setting.

Errors

The name must be explicitly listed in the database ACL. If it isn't, revokeAccess throws an exception, even if the name is a member of a group that is listed in the ACL.

Example