LlReturnObjectsByOwner

Template:Needs Translation/

函数名
Function: integer llReturnObjectsByOwner( key owner, integer scope );
参数：• key owner – avatar or group UUID • integer scope – OBJECT_RETURN_* flag
返回值：如果脚本属于代理，则所有者可以授予PERMISSION_RETURN_OBJECTS。如果脚本属于某个组，则此权限可以由属于该组“所有者”角色的代理授予。 返回一个整数，该整数表示成功返回给其所有者的对象的数量或一个ERR_*标志。 要运行这个函数，脚本必须使用llRequestPermissions请求PERMISSION_RETURN_OBJECTS权限。 如果返回值为负，则表示错误标志。 Specification Throttle Throttled at max parcel land impact capacity region-wide per hour.

注意事项

Permissions 不要依赖于权限的自动授予状态。始终使用run_time_permissions事件。 如果脚本缺少权限PERMISSION_RETURN_OBJECTS，该脚本将在DEBUG_CHANNEL上大叫一个错误，操作失败(但脚本继续运行)。 一旦PERMISSION_RETURN_OBJECTS权限被授予，除了从脚本内部(例如，使用一个新的llRequestPermissions调用)或者重置或删除脚本之外，就没有其他方法来撤销它。 当任何人都可以授予PERMISSION_RETURN_OBJECTS时，这个函数只有在以下条件之一为真时才能正常工作: 这片土地归正规化的所有人所有，该许可已由土地所有人批准。 该土地是组所有的，并且该许可由担任组“所有者”角色的组成员授予。 Parcel owner、estate owner和estate manager不能通过此方法返回其对象。 此方法不会返回土地设置为的组所拥有的对象。 如果对象是可转让的，其他组所拥有的对象将被归还给以前的所有者。如果不能转让，则删除。

示例
示例1

相关函数
llGetPermissions - 获得已授予的权限 llGetPermissionsKey - 获取授予权限的代理 llRequestPermissions - 请求的权限 llReturnObjectsByID llGetParcelPrimOwners llDie

相关事件
run_time_permissions - 允许接收事件

附录：（表格）

scope Flag		Description
OBJECT_RETURN_PARCEL		返回与脚本相同的包裹上由所有者拥有的所有对象。 脚本必须由地产经理或脚本所有者拥有的包裹拥有。
OBJECT_RETURN_PARCEL_OWNER		返回所有由所有者拥有的对象，这些对象在脚本所有者拥有的包裹上。
OBJECT_RETURN_REGION		返回所有者所拥有的区域中的所有对象。 脚本必须由地产所有者或地产经理拥有。

Error Flags		Description
ERR_GENERIC	-1	这是一个模糊的、无法解释的错误，对此一无所知。
ERR_MALFORMED_PARAMS	-3	参数是畸形的。
ERR_PARCEL_PERMISSIONS	-2	对特定的包裹执行任务缺乏许可。
ERR_RUNTIME_PERMISSIONS	-4	脚本没有运行时权限来执行请求的任务。
ERR_THROTTLED	-5	任务已被取消。稍后再试。