Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to: navigation, search
m
(According to Maestro Linden, a script error if the object owner is not allowed to manage the estate, is expected behavior)
Line 28: Line 28:
 
** if '''{{LSL Param|action}}''' is invalid,
 
** if '''{{LSL Param|action}}''' is invalid,
 
** if '''{{LSL Param|avatar}}''' is invalid or null
 
** if '''{{LSL Param|avatar}}''' is invalid or null
** if the object owner is not allowed to manage the estate.  
+
** <del>if the object owner is not allowed to manage the estate.</del>
 +
A call to llManageEstateAccess will produce a script error if the object owner is not allowed to manage the estate [https://jira.secondlife.com/browse/SCR-233 SRC-233]
 
|examples
 
|examples
 
|helpers
 
|helpers

Revision as of 17:19, 18 April 2012

Summary

Function: integer llManageEstateAccess( integer action, key avatar );

Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list.
Returns an integer representing a boolean, TRUE if the call was successful; FALSE if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.

• integer action ESTATE_ACCESS_* flag
• key avatar avatar or group UUID

Only works for objects owned by the Estate Owner or an Estate Manager.

action flag V Description
ESTATE_ACCESS_ALLOWED_AGENT_ADD 0x4 Add the agent to this estate's Allowed Residents list.
ESTATE_ACCESS_ALLOWED_AGENT_REMOVE 0x8 Remove the agent from this estate's Allowed Residents list.
ESTATE_ACCESS_ALLOWED_GROUP_ADD 0x10 Add the group to this estate's Allowed groups list.
ESTATE_ACCESS_ALLOWED_GROUP_REMOVE 0x20 Remove the group from this estate's Allowed groups list.
ESTATE_ACCESS_BANNED_AGENT_ADD 0x40 Add the agent to this estate's Banned residents list.
ESTATE_ACCESS_BANNED_AGENT_REMOVE 0x80 Remove the agent from this estate's Banned residents list.

Caveats

  • Calls are throttled at a rate of 30 calls per 30 seconds.
  • FALSE will be returned...
    • if throttled,
    • if action is invalid,
    • if avatar is invalid or null
    • if the object owner is not allowed to manage the estate.

A call to llManageEstateAccess will produce a script error if the object owner is not allowed to manage the estate SRC-233

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   ESTATE_ACCESS_BANNED_AGENT_ADD can ban estate owner!

Examples

Deep Notes

Search JIRA for related Issues

Signature

function integer llManageEstateAccess( integer action, key avatar );
integer ESTATE_ACCESS_BANNED_AGENT_REMOVE = 128;
integer ESTATE_ACCESS_BANNED_AGENT_ADD = 64;
integer ESTATE_ACCESS_ALLOWED_GROUP_REMOVE = 32;
integer ESTATE_ACCESS_ALLOWED_GROUP_ADD = 16;
integer ESTATE_ACCESS_ALLOWED_AGENT_REMOVE = 8;
integer ESTATE_ACCESS_ALLOWED_AGENT_ADD = 4;