@ResolveUserGroups

This @Function determines the complete name list for a specified Domino user, including all direct and indirect group memberships.
The function returns a TEXTLIST whose first element is the resolved user name. The subsequent elements contain all groups to which the user belongs, either directly or through nested groups.
Optionally, a VSPECHNAMELIST (HNL) can also be returned. This handle can subsequently be used by other functions, for example to determine the user’s effective access to a database. A returned handle must be released with @DestroyNameList after use.
For hierarchical Domino user names, the fully canonical name should be used, for example "CN=Max Mustermann/O=Example".

TEXT USERNAME:
The fully canonical name of the user, e.g. "CN=Max Mustermann/O=Example".

In case of an error, the @Function returns @ERROR; otherwise, it returns a TEXTLIST containing the user and the user’s group memberships.

Example: @ResolveUserGroups(USERNAME;RETHNAMELIST);

USERNAME:="CN=Max Mustermann/O=Example";
UserAndHisGroups:=@ResolveUserGroups(USERNAME;RETHNAMELIST);
@LogReport(@Implode(UserAndHisGroups;@Newline);3);
@LogReport(RETHNAMELIST;3);
@DestroyNameList(RETHNAMELIST);

The example determines all direct and indirect group memberships for the specified Domino user "CN=Max Mustermann/O=Example".
The returned name list is then logged to the APILOG.
In addition, the generated VSPECHNAMELIST RETHNAMELIST (HNL) is requested and released after use with @DestroyNameList.

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