@DestroyNameList

This @Function releases a previously created VSPECHNAMELIST (HNL) and sets the handle contained in it to NULL. It should be called as soon as the name list is no longer required.

VSPECHNAMELIST HNAMELIST:
A VSPECHNAMELIST handle to a name list, for example returned by @ResolveUserGroups.

As its return value, the @Function returns @ERROR in case of an error; otherwise, it returns TRUE.

Beispiel: @DestroyNameList(HNAMELIST);

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.