queryAccessPrivileges (Database - Java™)

Returns the privileges of a person, group, or server in a database.

Note: This method is new with Release 6.5.

Defined in

Database

Syntax

public int queryAccessPrivileges(String name)
    throws NotesException

Parameters

String name

The name of the person, group, or server. For a hierarchical name, the full name must be specified but can be in abbreviated format.

Return value

int

The current access privileges, a combination of the following:

  • Database.DBACL_CREATE_DOCS (1)
  • Database.DBACL_DELETE_DOCS (2)
  • Database.DBACL_CREATE_PRIV_AGENTS (4)
  • Database.DBACL_CREATE_PRIV_FOLDERS_VIEWS (8)
  • Database.DBACL_CREATE_SHARED_FOLDERS_VIEWS (16)
  • Database.DBACL_CREATE_SCRIPT_AGENTS (32)
  • Database.DBACL_READ_PUBLIC_DOCS (64)
  • Database.DBACL_WRITE_PUBLIC_DOCS (128)
  • Database.DBACL_REPLICATE_COPY_DOCS (256)

Individual privileges can be discerned through bitwise operations.

Usage

If the name you specify is listed explicitly in the ACL, then queryAccessPrivileges returns the privileges for that ACL entry and does not check groups.

If the name you specify is not listed explicitly in the ACL, queryAccessPrivileges checks to see if the name is a member of a group in the primary address book where the program is running: on a workstation the Personal Address Book; on a server the Domino® Directory.

Example