@DestroyNameList

Diese @Function gibt eine zuvor erzeugte VSPECHNAMELIST (HNL) wieder frei und setzt das darin enthaltene Handle auf NULL. Sie sollte aufgerufen werden, sobald die Namensliste nicht mehr benötigt wird.

VSPECHNAMELIST HNAMELIST:
Ein VSPECHNAMELIST-Handle auf eine Nameslist z.B. zurückgegeben von @ResolveUserGroups.

Als Return-Wert liefert die @Function bei einem Fehler @ERROR andernfalls TRUE.

Beispiel: @DestroyNameList(HNAMELIST);

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

Das Beispiel ermittelt für den angegebenen Domino-Benutzer "CN=Max Mustermann/O=Example" alle direkten und indirekten Gruppenzugehörigkeiten.
Die zurückgegebene Namensliste wird anschließend im APILOG protokolliert.
Zusätzlich wird die erzeugte VSPECHNAMELIST RETHNAMELIST (HNL) angefordert und nach der Verwendung mit @DestroyNameList wieder freigegeben.