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

Note This method is new with Release 6.

Defined in

NotesDatabase

Syntax

roles = notesDatabase.QueryAccessRoles( name$ )

Parameters

name$

String. The name of the person, group, or server.

roles

String array.
• If the name has roles, each element of the array contains one role. Each role name is surrounded by square brackets, for example, "[Supervisor]."
• If the name has no roles, the array has one element that contains an empty string.

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, QueryAccess 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

@UserRoles function in formula language

@UserNamesList function in formula language

Example
See Also

Examining and adjusting an access control list

Glossary