LlReturnObjectsByID
首页 | 函数 | 事件 | 类型 | 操作符 | 常数 | Flow Control | Script Library | Categorized Library | Tutorials |
函数名 |
---|
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 |
相关函数 |
---|
llGetPermissions - 获得已授予的权限
llGetPermissionsKey - 获取授予权限的代理 llRequestPermissions - 请求的权限 |
相关事件 |
---|
run_time_permissions - 允许接收事件 |
附录:(表格)
Error Flags | Description | |
---|---|---|
ERR_GENERIC | -1 | 这是一个模糊的、无法解释的错误,对此一无所知。 |
ERR_MALFORMED_PARAMS | -3 | 参数是畸形的。 |
ERR_PARCEL_PERMISSIONS | -2 | 对特定的包裹执行任务缺乏许可。 |
ERR_RUNTIME_PERMISSIONS | -4 | 脚本没有运行时权限来执行请求的任务。 |
ERR_THROTTLED | -5 | 任务已被取消。稍后再试 |