Difference between revisions of "LlReturnObjectsByID"

From Second Life Wiki
Jump to navigation Jump to search
m (Created page with "{{LSL_Function |inject-2= {{LSL_Function/permission|PERMISSION_RETURN_OBJECTS}} |func_id=|func_sleep=0.0|func_energy= |func=llReturnObjectsByID|sort=llReturnObjectsByID |p1_type=…")
 
m
Line 8: Line 8:
|func_footnote
|func_footnote
|func_desc
|func_desc
|return_text=that is the number of items returned or an ERR_* flag (if the value is negative, it's an error flag).
|return_text=that is the number of items returned or an [[#{{anchorencode:Error Flags}}|ERR_*]] flag (if the value is negative, it's an error flag).
|spec
|spec
|caveats
|caveats

Revision as of 21:47, 14 June 2013

Summary

Function: integer llReturnObjectsByID( list objects );

Returns an integer that is the number of items returned or an ERR_* flag (if the value is negative, it's an error flag).

• list objects list of object uuids (keys)

To run this function the script must request the PERMISSION_RETURN_OBJECTS permission with llRequestPermissions.

Error Flags Description
ERR_GENERIC -1 A nebulous and inexplicable error, nothing is known about it.
ERR_PARCEL_PERMISSIONS -2 Permission lacked to perform task on specified parcel.
ERR_MALFORMED_PARAMS -3 Parameters are malformed.
ERR_RUNTIME_PERMISSIONS -4 Script lacks the runtime permission to perform the requested task.
ERR_THROTTLED -5 Task has been throttled. Try again later.

Caveats

Permissions
  • Once the PERMISSION_RETURN_OBJECTS permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.
  • While anyone may grant PERMISSION_RETURN_OBJECTS this function will only work properly if one of the following is true:
    • The land is owned by the prim owner and this permission has been granted by the land owner.
    • The land is group owned and this permission has been granted by a group member filling the group "Owners" role.
All Issues ~ Search JIRA for related Bugs

Examples

See Also

Events

•  run_time_permissions Permission receiving event

Functions

•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
•  llReturnObjectsByOwner
•  llGetParcelPrimOwners

Articles

•  Script permissions

Deep Notes

Search JIRA for related Issues

Signature

function integer llReturnObjectsByID( list objects );