IORRWriteState() 函数

IORRWriteState() 函数将应用程序远程标记的当前状态信息保存到文本文件。如果不存在该文件，此函数会创建它。每次运行包含此函数的脚本时，都会将新的信息附加到该文件中。

您可以指定将哪些远程标记信息保存到文件。另外，此函数的返回值会指出信息是否已成功添加到文件中。

类别

其它

语法

IORRWriteState(FilePath, Option, " ");

参数

FilePath

文本文件的完整文件夹路径，该文件包含有关应用程序远程标记的信息。FilePath 参数可以是字符串常量或消息标记。

选项

整型标记或整型常数，指定写入文件的远程标记计数信息。可能的值有：

" "（空字符串）

此参数保留下来供将来使用，但在脚本的 IORRWriteState() 函数中必须包含它。

结果

下面是一些示例，用来解释由 IORRWriteState() 函数调用保存到文件的信息。

当前地址列表

输出文件中的下面这行代码显示完全激活且可以更新的远程引用标记的示例。这行代码显示地址 65535 指定给了 TestProt:di000 远程引用标记：

65535 <TestProt:di000> (RAA) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

远程引用标记名后面是圆括号括起来的三个标帜：

• 第一个标帜 R 表示标记的远程引用已经成功解析。如果标记的远程引用仍然等待处理，则指定给第一个标帜的值是 X。

• 第二个标帜表示远程标记当前处于活动状态 A，还是处于不活动状态 D。

• 第三个标帜表示由于许可证限制该地址是允许的 A，还是不允许的 D。

C 后面的日期表示创建远程标记的时间。A 后面的日期显示最近激活标记的时间。如果远程引用标记已在 InTouch 应用程序运行时停用，这行代码会在最后包含一个停用时间。

输出文件中的下面这行代码显示超出 InTouch 许可证标记计数限制的活动远程引用标记的示例。标记的远程引用已成功解析，且标记当前处于活动状态：

65414 <TestProt:di121> (RAD) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

但 InTouch 应用程序中不更新标记值，这是因为指定给远程引用标记的地址超出了 InTouch 许可证的标记计数限制。

活动地址列表

输出文件中的下面这行代码显示完全激活的远程标记的示例，指定给该标记的值会更新 InTouch 应用程序：

65429 <TestProt:di106> (A) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

第一个数字是远程标记句柄，其后是地址，然后是表示允许的标帜 A，或表示不允许的标帜 D。输出行中标帜的后面是创建时间、最近激活时间以及最近停用时间。如果该远程标记在应用程序运行期间尚未停用过，则停用时间不会出现。

输出文件中的下面这行代码显示超出许可证限制的活动远程标记的示例：

65342 <TestProt:di193> (D) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

许可的地址

列表中的下面这行代码显示指定给远程引用标记的地址以及它添加到列表的时间。

<testprot:di000> {C:5/23/2007 9:58:36 AM}

拒绝的地址

由于实施限制或由于标记计数超出许可证最大值，被拒绝的地址出现在列表中。

本例显示超出许可证限制的远程标记地址：

testprot:di125 [1] (L) {F:5/23/2007 9:58:39 AM} {R:5/23/2007 9:58:39 AM}

地址与计数一起列出，指出尝试了多少次去引用该项目。标帜指出该地址是由于超出许可证限制 (L)，还是由于内部实施限制 (I) 而出现在列表中。两个时间分别代表它第一次添加到列表的时间与最近访问的时间。

示例

本例将当前激活的远程标记地址写入到 c:\intouch\data 文件夹下的文件中。ReturnValue 标记会被指定给一个整数，指出函数调用是否成功地将远程标记信息写入文件中。

ReturnValue = IORRWriteState("c:\intouch\data", 2, "");