Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to: navigation, search
(According to Maestro Linden, a script error if the object owner is not allowed to manage the estate, is expected behavior)
(rewriting to include error message text (which is more cryptic than most caveats).)
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
** <del>if the object owner is not allowed to manage the estate.</del>
+
* If the object owner is not allowed to manage the estate the message "llManageEstateAccess object owner must manage estate." is [[llShout|shouted]] on [[DEBUG_CHANNEL]]. -- {{Jira|SRC-233}}
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 22:37, 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 the message "llManageEstateAccess object owner must manage estate." is shouted on DEBUG_CHANNEL. -- 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;