Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to: navigation, search
m
m
Line 1: Line 1:
 
{{LSL_Function
 
{{LSL_Function
|inject-2={{LSL_Function/avatar|avatar|group=*}}
+
|inject-2=
 +
{{LSL_Function/avatar|avatar|group=*}}
 +
<!-- Grab caveats etc from them -->
 +
{{:ESTATE_ACCESS_ALLOWED_AGENT_ADD|set}}
 +
{{:ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|set}}
 +
{{:ESTATE_ACCESS_ALLOWED_GROUP_ADD|set}}
 +
{{:ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|set}}
 +
{{:ESTATE_ACCESS_BANNED_AGENT_ADD|set}}
 +
{{:ESTATE_ACCESS_BANNED_AGENT_REMOVE|set}}
 
|func=llManageEstateAccess
 
|func=llManageEstateAccess
 
|sort=ManageEstateAccess
 
|sort=ManageEstateAccess
Line 11: Line 19:
 
|return_type=integer
 
|return_type=integer
 
|constants=
 
|constants=
{{{!}} class="sortable" {{Prettytable}}
+
{{LSL Constants/llManageEstateAccess}}
{{!}}- {{Hl2}}
+
|signature
!{{!}} '''{{LSL Param|action}}''' flag
+
! title="Value" {{!}} V
+
!{{!}} Description
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_AGENT_ADD|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Add the agent to this estate's Allowed Residents list.
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Remove the agent from this estate's Allowed Residents list.
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_GROUP_ADD|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Add the group to this estate's Allowed groups list.
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Remove the group from this estate's Allowed groups list.
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_BANNED_AGENT_ADD|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Add the agent to this estate's Banned residents list.
+
{{!}}-
+
{{!}} {{LSL Const|ESTATE_ACCESS_BANNED_AGENT_REMOVE|integer}}
+
{{!}} {{#var:value}}
+
{{!}} Remove the agent from this estate's Banned residents list.
+
{{!}}}
+
|signature=
+
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_AGENT_ADD|integer}}
+
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|integer}}
+
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_GROUP_ADD|integer}}
+
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|integer}}
+
{{LSL Const/Signature|ESTATE_ACCESS_BANNED_AGENT_ADD|integer}}
+
{{LSL Const/Signature|ESTATE_ACCESS_BANNED_AGENT_REMOVE|integer}}
+
 
|spec
 
|spec
 
|caveats=
 
|caveats=

Revision as of 12:20, 26 March 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.

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;