Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to navigation Jump to 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;