LlReturnObjectsByOwner

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

ReturnObjectsByOwner

llReturnObjectsByOwner

Summary

1 Bug

Function: integer llReturnObjectsByOwner( key owner, integer scope );

0.0	Forced Delay
	Energy

Returns an integer that is the number of objects successfully returned to their owners or an ERR_* flag.

• key	owner	–	avatar or group UUID
• integer	scope	–	OBJECT_RETURN_* flag

To run this function the script must request the PERMISSION_RETURN_OBJECTS permission with llRequestPermissions. If the return value is negative, it represents an error flag.

Specification

Throttle

Throttled at max parcel land impact capacity region-wide per hour.

scope Flag		Description
OBJECT_RETURN_PARCEL		Return all objects on the same parcel as the script which are owned by owner. The script must be owned by an estate manager or over a parcel owned by the owner of the script.
OBJECT_RETURN_PARCEL_OWNER		Return all objects owned by owner which are over parcels owned by the owner of the script.
OBJECT_RETURN_REGION		Return all objects in the region owned by owner. The script must be owned by the estate owner or an estate manager.

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

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks the permission PERMISSION_RETURN_OBJECTS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). 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.

• Parcel owner, estate owner and estate managers can not have their objects returned by this method.
• Objects which are owned by the group the land is set to will not be returned by this method.
  • Objects owned by other groups will be deleted, not returned.

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
•	llReturnObjectsByID
•	llGetParcelPrimOwners

Articles

•

Script permissions

Deep Notes

Signature
function integer llReturnObjectsByOwner( key owner, integer scope );