QueryAccessRoles (NotesDatabase - LotusScript®)

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

Note: This method is new with Release 6.

Defined in



roles = notesDatabase .QueryAccessRoles( name$ )



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

Return value


String array.

  • If the name has roles, each element of the array contains one role. Each role name is surrounded by 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.