Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to: navigation, search
(rewriting to include error message text (which is more cryptic than most caveats).)
m
Line 26: Line 26:
 
* [[FALSE]] will be returned...
 
* [[FALSE]] will be returned...
 
** if throttled,
 
** if throttled,
** if '''{{LSL Param|action}}''' is invalid,
+
** if {{LSLP|action}} is invalid,
** if '''{{LSL Param|avatar}}''' is invalid or null
+
** if {{LSLP|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 [[llShout|shouted]] on [[DEBUG_CHANNEL]]. -- {{Jira|SRC-233}}
 
* 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}}
 
|examples
 
|examples

Revision as of 12:43, 8 June 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;