$ZF(-6)
按用户索引访问库$ZF(-6)
函数提供了一个有效的接口,允许通过全局定义的索引访问 Callout
库,甚至可以由不知道共享库文件位置的应用程序使用。用户自定义索引表存储由库ID
号和对应的库文件名组成的键值对。重命名或重新定位库文件时,可以更改与给定库 ID
关联的文件名。此更改对于按索引号加载库的应用程序来说是透明的。提供其他 $ZF
函数来创建和维护索引表,以及卸载 $ZF(-6)
加载的库。
本节讨论以下 $ZF
函数:
$ZF(-6)
— 从用户指定的索引号引用的标注库中调用函数。如果尚未加载,则自动加载库。$ZF(-4,4)
— 卸载由索引号指定的标注库。$ZF(-4,5)
和 $ZF(-4,6)
— 创建或删除系统索引表中的条目。系统索引对 IRIS
实例中的所有进程Global
可用。.$ZF(-4,7)
和 $ZF(-4,8)
— 创建或删除进程索引表中的条目。进程表在系统表之前被搜索,因此可以在进程中使用它们来覆盖系统范围的定义。$ZF(-6)
接口与 $ZF(-5)
使用的接口类似(请参阅“使用 $ZF(-5)
通过系统 ID
访问库”),但有以下区别:
$ZF(-6)
之前,必须创建库索引表。库索引值是用户定义的,可以在运行时更改或覆盖。$ZF
函数来加载库。相反,库由调用其函数之一的第一个 $ZF(-6)
调用自动加载。ID
(由它们在 ZFEntry
表中的顺序确定),因此没有 $ZF
函数会返回给定名称和库索引值的函数 ID
。以下示例演示了如何使用 $ZF(-6)
接口。第一个示例在系统索引表中定义了库 ID
,第二个示例(可以从不同的应用程序调用)使用库 ID
来调用库函数:
$ZF(-4,5)
定义系统索引条目此示例将 100
设置为系统索引表中 mylibrary.dll
的库 ID
。如果该编号已存在定义,则会将其删除并替换。
set LibID = 100
set status=$ZF(-4,4,LibID) // unload any existing library with this ID value
set status = $ZF(-4,5,LibID,"C:\calloutlibs\mylibrary.dll") // set system ID
LibID
是开发者选择的索引号。它可以是任何大于零的整数,保留的系统值 1024
到 2047
除外。100
的库,则应在替换条目之前卸载该库。$ZF(-4,5)
的调用将索引号 100
与库文件 mylibrary.dll
相关联。一旦在系统索引表中定义了库 ID
,它就可供 IRIS
当前实例中的所有进程Global
使用。
$ZF(-6)
调用函数本示例使用上一示例中创建的系统索引表。它使用 $ZF(-6)
加载库并调用库函数,然后卸载库。不必从在系统索引中定义库 ID
的同一应用程序调用此代码:
set LibID = 100 // library ID in system index table
set FuncID = 2 // second function in library ZFEntry table
set x = $ZF(-6,LibID, FuncID, "arg1") // call function 2
set status = $ZF(-4,4,LibID) // unload the library
LibID
是系统索引中定义的库 ID
。该应用程序不必知道库名称或路径即可使用库函数。FuncID
是库 LibID
的 ZFEntry
表中列出的第二个函数的函数标识符。假设开发人员可以访问库代码 - (-6)
接口没有通过指定库函数名称来检索此数字的函数。$ZF(-6)
的调用指定 100
作为库 ID
,2
作为函数 ID
,“arg1”
作为传递给函数的参数。如果尚未加载,此调用将加载 Callout
库 mylibrary.dll
,并将调用 ZFEntry
表中列出的第二个函数。$ZF(-4,4)
的调用会卸载该库。由 $ZF(-6)
加载的每个库都将保持驻留,直到进程结束或由 $ZF(-4,4)
卸载。