@ACLSetAdminServer

Diese @Function setzt in eine zuvor über @ReadACL eingelesene in Memory Kopie einer ACL, repräsentiert durch den VSPECHACL-Handle hACL, den Admin Server TEXT ADMINSERVERNAME für diese DB.

VSPECHACL hACL:
Ein VSPECHACL-Handle wie er von @ReadACL zurückgeliefert wird.

TEXT ADMINSERVERNAME:
Der zu setzende Name des Administration Servers.

Return:
Im Fehlerfall liefert die @Function @Error zurück, andernfalls TRUE.

Beispiel: @ACLSetAdminServer(HACL;ADMINSERVERNAME);

dbPath:="TEST\\TESTDB1.NSF";

dbh:=@OpenDB(dbPath);
hACL:=@ReadACL(dbh);

ADMINSERVERNAME:="TEST-SERVER/ACME/DE";
Ret:=@ACLSetAdminServer(hACL;ADMINSERVERNAME);

Ret:=@WriteACL(dbh;hACL);
hACL:=@ReleaseACL(hACL);
dbh:=@CloseDB(dbh);

Das Beispiel öffnet die Datenbank TEST\TESTDB1.NSF und erzeugt eine In-Memory-Kopie ihrer ACL.
Anschließend wird TEST-SERVER/ACME/DE mit @ACLSetAdminServer als Administrationsserver in dieser ACL-Kopie gesetzt.
Die geänderte ACL wird danach mit @WriteACL in die Datenbank zurückgeschrieben.
Abschließend wird der ACL-Handle freigegeben und die Datenbank geschlossen.