@GetACL

Retrieves the ACL of the database with the OSPATH OSPATH, DBHANDLE DBHANDLE or HACL HACL and returns it split into TEXTLIST USERNAMES, NUMBERLIST USERLEVELS, TEXTLIST USERPRIVILEGES and TEXTLIST PRIVILEGESNAMES.

TESTLIST USERNAMES:
The ACL name entries.

NUMBERLIST USERLEVELS:
The corresponding ACL level.

6=(Manager)   Manager
5=(Developer)   Developer
4=(Editor)   Editor
3=(Author)   Author
2=(Reader)   Reader
1=(Depositor)   Depositor
0=(No Access)   No Access

TEXTLIST USERPRIVILEGES:
The user’s privileges and ACL flags. The individual privileges and ACL flags are separated by commas.
The first 5 ACL privileges are reserved for pre-V3-Notes databases.
Although these privileges can still be queried here and can also be set using the Engine, they should no longer be used (legacy support only!).

Roles/Privileges:
1-5   pre V3 privileges
6-80 >V3 roles

ACL-Flags:
ACC Author can create new documents
CPA Create personal agent allowed
CPF Create personal folder/view allowed
CD Can delete (on a level >= Author)
CF Create Folder allowed
CLS Create Lotus Script allowed
ASRV Admin-Server entry
SRV Server entry
PRS Personen entry
GRP Gruppen entry
RPD Read public documents
WPD Write public documents
MDA The user cannot register monitors for this database
NRC The user can neither copy nor replicate this database
ARA The administration server can modify Reader or Author fields

TEXTLIST PRIVILEGESNAMES:
The names of the privileges.

NUMBER FLAGS:
Hex   Dez   Meaning
0x00001   00001   Enforce a consistent ACL across all replicas
0x00002   00002   Extened Access
0x00004   00004   Reserved/Unknown
0x04000   16384   Admin server can modify reader and author fields in database
0x10000   65536   Admin server can modify names fields in database

Return:
In case of an error, the @Function returns @ERROR; otherwise, it returns TRUE.

Example: @GetACL(OSPATH;USERNAMES;USERLEVELS;USERPRIVILEGES;PRIVILEGESNAMES)

OSPATH:="LOAPI.NSF";
@GetACL(OSPATH;USERNAMES;USERLEVELS;USERPRIVILEGES;PRIVILEGESNAMES);

Returns (usually) the ACL of the API program control in the variables USERNAMES, USERLEVELS, USERPRIVILEGES and PRIVILEGESNAMES.

Note : This text was machine-translated and may contain inaccuracies.