第二十章 调用Callout Library函数 - 使用 $ZF(-6) 按用户索引访问库

发布时间:2024年01月11日

第二十章 调用Callout Library函数 - 使用 $ZF(-6) 按用户索引访问库

使用 $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是开发者选择的索引号。它可以是任何大于零的整数,保留的系统值 10242047 除外。
  • 如果已加载索引号为 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 是库 LibIDZFEntry 表中列出的第二个函数的函数标识符。假设开发人员可以访问库代码 - (-6) 接口没有通过指定库函数名称来检索此数字的函数。
  • $ZF(-6) 的调用指定 100 作为库 ID2 作为函数 ID“arg1”作为传递给函数的参数。如果尚未加载,此调用将加载 Calloutmylibrary.dll,并将调用 ZFEntry 表中列出的第二个函数。
  • $ZF(-4,4) 的调用会卸载该库。由 $ZF(-6) 加载的每个库都将保持驻留,直到进程结束或由 $ZF(-4,4) 卸载。
文章来源:https://blog.csdn.net/yaoxin521123/article/details/135517243
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。