llTransferOwnership

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/ja 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

GiveInventory

llTransferOwnership

Summary

1/2 Bugs

Function: llTransferOwnership( key agent_id, integer flags, list options );

0.0	Forced Delay
10.0	Energy

Transfer ownership of the object containing this script to agent_id.

• key	agent_id	–	Agent ID for the avatar to receive ownership of the object
• integer	flags	–	Flags controlling transfer behavior.
• list	options	–	Options applied to the ownership transfer. No options are defined at this time.

Specification

Transfers ownership of an object rezzed in world to agent_id. The object must be transferable by its current owner and must not be an attachment.

Optionally this function may force the object to derez itself into the destination agent's inventory, or make a copy of itself directly into inventory.

Transfer Flags

Constant		Description
TRANSFER_FLAG_RESERVED	0x0001	Reserved, do not use.
TRANSFER_FLAG_TAKE	0x0002	When transfer is accepted, immediately take the object into inventory.
TRANSFER_FLAG_COPY	0x0004	Give a copy of the object and place it into the destination agent's inventory.

Transfer Errors

Constant		Description
TRANSFER_OK	0	No error detected, inventory transferred
TRANSFER_BAD_OPTS	-1	A bad option was passed in the options list.
TRANSFER_NO_TARGET	-2	Could not find the receiving agent in the current region.
TRANSFER_THROTTLE	-3	Transfer rate exceeded the inventory transfer throttle.
TRANSFER_NO_ITEMS	-4	The list of items was empty or contained only non-transferable items.
TRANSFER_BAD_ROOT	-5	The root path specified in TRANSFER_DEST contained an invalid directory or was reduced to nothing.
TRANSFER_NO_PERMS	-6	The object does not have transfer permissions.
TRANSFER_NO_ATTACHMENT	-7	Can not transfer ownership of an attached object.

Caveats

• agent_id must be an agent in the region.
• There is no way to detect if the receiver ignored, rejected or blocked the transaction (aside from a changed event never occurring.)
• The function fails with a return code of TRANSFER_NO_PERMS if:
  • The object is no-transfer.
  • The object is no-copy and flags includes the TRANSFER_FLAG_COPY flag.
• Calling this function from an attachment will fail and return TRANSFER_NO_ATTACHMENT
• WARNING: Any no-trans items in the transferred object will be removed from the object received by the target agent. If the transfer is of the object itself, these items are lost.
• WARNING: If the transfer is a copy, any no-copy inventory items will be present in the object received by the target agent and removed from the original.

Examples

See Also

Events

•

changed

Functions

•	llGiveInventoryList
•	llRemoteLoadScriptPin
•	llSetRemoteScriptAccessPin
•	llMapDestination

Deep Notes

Signature
function void llTransferOwnership( key agent_id, integer flags, list options );