[toc]

第二十六章 ZF(-6)：按用户索引调用

$ZF(-6)：按用户索引调用

$ZF(-6) 接口通过用户定义的索引表提供对 Callout 库的访问，甚至可以由不知道共享库文件位置的应用程序使用。

实用函数 $ZF(-4, 4) 到 $ZF(-4, 8) 仅由 $ZF(-6) 使用。它们提供卸载库以及创建或维护索引的服务。

$ZF(-6)

在索引 Callout 库中查找并执行函数。

   retval = $ZF(-6,lib_index,func_id,args)

参数：

• lib_index — Callout 库的用户指定索引（由 $ZF(-4,5) 或 $ZF(-4,7) 创建）
• func_id —（可选）Callout 库中函数的 ID 号，它是库的 ZFEntry 表中的函数索引。如果省略，调用将验证 lib_index 的有效性、加载库并返回完整的库文件名。
• args —（可选）包含库函数所需的任何参数的逗号分隔列表。

返回值：

• retval — 库函数的输出值，如果库函数未设置输出值，则为 NULL。

注意：对于实用函数 $ZF(-4, 1)、$ZF(-4, 2) 和 $ZF(-4, 3)，请参阅上一节（“$ZF(-5)：通过系统 ID 调用” ”）

$ZF(-4, 4)

实用函数与 $ZF(-6) 一起使用。卸载由索引号指定的标注库。

   $ZF(-4,4,lib_index)

参数：

• lib_index — 用户指定的标注库索引号（由 $ZF(-4,5) 或 $ZF(-4,7) 创建）

$ZF(-4, 5)

实用函数与 $ZF(-6) 一起使用。在标注系统索引表中创建一个条目。

   $ZF(-4,5,lib_index,lib_name)

参数：

• lib_index — 用户指定的唯一编号，用于引用标注库。
• lib_name — 要索引的标注库的名称。

$ZF(-4, 6)

实用函数与 $ZF(-6) 一起使用。删除标注系统索引表中的条目。

   $ZF(-4,6,lib_index)

参数：

• lib_index — 先前通过调用 $ZF(-4,5) 定义的索引号。该参数是必需的（与 $ZF(-4,8) 不同，$ZF(-4,8) 可以省略）。

$ZF(-4,7)

实用函数与 $ZF(-6) 一起使用。在 Callout 进程索引表中创建一个条目。

   $ZF(-4,7,lib_index,lib_name)

参数：

• lib_index — 用户指定的唯一编号，用于引用标注库。
• lib_name — 要索引的标注库的名称。

$ZF(-4,8)

实用函数与 $ZF(-6) 一起使用。从 Callout 进程索引表中删除条目。如果未指定索引号，则删除所有索引条目。

   $ZF(-4,8,lib_index)

参数：

• lib_index —（可选）先前通过调用 $ZF(-4,7) 定义的索引号。如果未指定，则删除所有索引条目。