IORRGetSystemInfo() 函数
- Last UpdatedSep 24, 2024
- 1 minute read
IORRGetSystemInfo() 函数返回正在运行的 InTouch 应用程序的标记计数。IORRGetSystemInfo() 函数根据参数值返回一个数值，该数值可以是：
-
InTouch 许可证指定的最大远程标记地址数。
-
在 InTouch 应用程序运行期间根据许可证统计的远程标记地址数。
-
InTouch 应用程序中当前激活的远程标记数。
-
正在运行的 InTouch 应用程序中可用的远程标记数。
-
当前禁用的远程引用标记数。
-
正在运行的 InTouch 应用程序中的本地标记数。
-
如果函数调用期间发生错误，或 Option 参数指定为无效的值，则为 -1。
类别
其它
语法
IORRGetSystemInfo(Option);
参数
选项
整型标记或整型常数，指定要返回的远程引用标记计数的类型。可能的值有：
|
1 |
根据 InTouch 许可证返回允许的最大远程标记地址数。本地 I/O 标记不记入远程标记计数。 在 InTouch 应用程序运行时，此数字为常数。 |
|
2 |
返回根据许可证限制统计的独特远程标记地址数，这些地址是在 InTouch 应用程序运行时激活的。本地 I/O 标记不记入远程标记计数。 如果许可证允许使用 60K 以上的远程引用标记，则不论激活了多少远程标记地址，此数字都可能是 0。在无限制许可证下运行时，WindowViewer 不统计激活的远程标记地址。 在具有远程标记限制的许可证下运行应用程序时，此计数会递增，直至达到远程标记许可证计数的限制。达到远程标记限制之后，便无法激活更多的远程标记地址。此时仅能重新激活当前已激活的地址。通过使用将 Option 参数设置为 3 的 IORRWriteState，可以获取根据许可证限制统计的远程引用标记的列表。 |
|
3 |
返回 InTouch 应用程序中当前已激活的远程引用标记数。 |
|
4 |
返回可以在 InTouch 应用程序中激活且不会导致缺少远程标记句柄的远程引用标记数。应用程序在运行时，此计数通常会发生变化。停止与启动脚本、打开与关闭包含远程引用标记的窗口时，都会影响远程引用标记计数。 此数字可以少于许可证上剩余的数字，尤其是在许可证没有限制的情况下。发生这种情况是因为存在一个内部限制来确定同时可以有多少个活动的远程引用标记。 |
|
5 |
返回 InTouch 应用程序中当前处于禁用状态的远程标记数。 |
|
6 |
返回 InTouch 应用程序中当前的本地标记数。 |
示例
以下示例返回 InTouch 应用程序正在运行时根据许可证限制统计的远程引用标记数。返回的远程引用标记计数被指定 RRTagCount 整型标记的值。
RRTagCount = IORRGetSystemInfo(2);