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

Note This method is new with Release 6.

Defined in

Database

Syntax

public java.util.Vector queryAccessRoles(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.

Vector

A vector with elements of type String.
• If the name has roles, each element of the vector contains one role.
• If the name has no roles, the vector has a size of 0.

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

If the name you specify is not listed explicitly in the ACL, queryAccessRoles 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.

Language cross-reference

QueryAccessRoles method in LotusScript NotesDatabase class

@UserRoles function in formula language

@UserNamesList function in formula language

Example
See Also

Examining and adjusting an access control list

Glossary