Difference between revisions of "LlManageEstateAccess"
Jump to navigation
Jump to search
m (added date of release) |
m |
||
| Line 18: | Line 18: | ||
|func_desc=Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list. | |func_desc=Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list. | ||
|func_footnote=Only works for objects owned by the Estate Owner or an [[Estate Manager]]. By default, the object owner is notified of every change made using this function. But if the owner grants [[PERMISSION_SILENT_ESTATE_MANAGEMENT]] to the script, the owner will not be notified. | |func_footnote=Only works for objects owned by the Estate Owner or an [[Estate Manager]]. By default, the object owner is notified of every change made using this function. But if the owner grants [[PERMISSION_SILENT_ESTATE_MANAGEMENT]] to the script, the owner will not be notified. | ||
|return_text= | |return_text=[[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. | ||
|return_type=integer | |return_type=integer | ||
|return_subtype=boolean | |||
|constants= | |constants= | ||
{{LSL Constants/llManageEstateAccess}} | {{LSL Constants/llManageEstateAccess}} | ||
Revision as of 02:11, 4 January 2014
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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 a boolean (an integer) 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. By default, the object owner is notified of every change made using this function. But if the owner grants PERMISSION_SILENT_ESTATE_MANAGEMENT to the script, the owner will not be notified.
| 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
Examples
See Also
Deep Notes
History
Date of Release 18/10/2011
Signature |
|---|
function integer llManageEstateAccess( integer action, key avatar ); |