IORRGetItemActiveState() 函数
- Last UpdatedSep 24, 2024
- 1 minute read
IORRGetItemActiveState() 函数返回指定的远程标记地址的状态。
类别
其它
语法
IORRGetItemActiveState(ItemPath, Option);
参数
ItemPath
ItemPath 是代表所关注的地址的字符串。ItemPath 可以是字符串常量或消息标记。
选项
整型标记或整型常数，指定要返回的远程引用标记计数的类型。可能的值有：
|
1 |
确定当前远程标记地址目前是否处于活动状态。 如果是当前的活动地址，则返回值为 1。如果不是当前地址，则返回值为 -1。 如果是当前地址但并非处于活动状态，则返回值为 0。 |
|
2 |
确定当前远程标记地址在应用程序运行期间是否激活过。 如果是当前地址，并且至少激活过一次，则返回值为 1。如果不是当前地址，则返回值为 -1。如果是当前地址但从未激活过，则返回值为 0。 |
|
3 |
确定当前远程标记地址是否停用过。 如果不是当前地址，则返回值为 -1。 如果是当前地址但从未停用过，则返回值为 0。 |
|
4 |
确定当前远程标记地址是否已禁用。 如果是当前地址，且至少停用过一次，则返回值为 1。如果不是当前地址，则返回值为 -1。如果地址未禁用，则返回值为 0。如果是当前地址，并且已禁用，则返回值为 1。 |
|
5 |
确定地址是否在允许的列表中。 如果地址不在列表中，则返回值为 0。 如果地址在列表中，则返回值为 1。 |
|
6 |
确定地址是否在拒绝的列表中。 如果地址不在列表中，则返回值为 0。 如果地址在列表中，则返回值为 1。 |
示例
本例确定 TestProt:di000 远程标记地址当前是否处于活动状态：
ReturnValue = IORRGetItemActiveState("TestProt:di000", 1);
本例确定 TestProt:di121 远程标记地址当前是否已禁用：
ReturnValue = IORRGetItemActiveState("TestProt:di121", 4);
本例确定当前是否根据许可证限制来统计 TestProt:di001 远程标记地址。
ReturnValue = IORRGetItemActiveState("TestProt:di001", 5);