查看“LlReturnObjectsByID”的源代码

{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}}


{{函数详情
|函数名 = Function:  integer llReturnObjectsByID( list objects );
|参数= 参数：• list objects – 对象uuid(键)列表
|返回值= 返回值：如果脚本属于代理，则所有者可以授予[[PERMISSION_RETURN_OBJECTS]]。如果脚本属于某个组，则此权限可以由属于该组“所有者”角色的代理授予。

返回一个整数，该整数表示成功返回给其所有者的对象的数量或一个ERR_*标志。

要运行这个函数，脚本必须使用[[llRequestPermissions]]请求[[PERMISSION_RETURN_OBJECTS]]权限。

如果返回值为负，则表示错误标志。

  Specification
  脚本所有者和范围
  如果该脚本属于地产所有者或经理，则此函数适用于该区域中任何包裹上的对象。否则，脚本可以返回位于脚本所有者拥有的土地上的对象。
  作为一种安全措施，parcel owner、estate owner和estate managers不能通过此方法返回其对象，除非对象返回自身。
  Throttle
  在最大的地块陆地冲击能力范围内，每小时。

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

如果对象是可转移的，其他组所拥有的对象将被返回给它们以前的所有者，否则将被删除。

|示例=
示例1
<pre>
</pre>

|相关函数=
[[llGetPermissions]] - 获得已授予的权限

[[llGetPermissionsKey]] - 获取授予权限的代理

[[llRequestPermissions]] - 请求的权限

[[llReturnObjectsByOwner]]

[[llGetParcelPrimOwners]]

[[llDie]]   

|相关事件=
[[run_time_permissions]] - 允许接收事件
}}
附录：（表格）
{| class="wikitable" border="1"
|-
! Error Flags
! 
! Description
|-
| [[ERR_GENERIC]]
| -1
| 这是一个模糊的、无法解释的错误，对此一无所知。
|-
| [[ERR_MALFORMED_PARAMS]]
| -3
| 参数是畸形的。
|-
| [[ERR_PARCEL_PERMISSIONS]] 
| -2
| 对特定的包裹执行任务缺乏许可。
|-
| [[ERR_RUNTIME_PERMISSIONS]]
| -4
| 脚本没有运行时权限来执行请求的任务。
|-
| [[ERR_THROTTLED]]
| -5
| 任务已被取消。稍后再试
|}