IORRWriteState() 関数IORRWriteState()かんすう

IORRWriteState() 関数により、アプリケーションのリモート タグの現在の状態に関する情報がテキスト ファイルに保存されます。ファイルが存在しない場合、関数によって作成されます。関数が含まれているスクリプトが実行されるたびに、新しい情報がファイルに連結されます。

どのようなリモート タグ情報がファイルに保存されるのかを指定できます。また、関数の戻り値は、情報がファイルに正常に追加されたかどうかを示します。

カテゴリ

その他

構文

IORRWriteState(FilePath, Option, " ");

引数

FilePath

アプリケーションのリモート タグに関する情報が含まれているテキスト ファイルへの完全フォルダ パス。FilePath 引数は、文字列定数またはメッセージ型タグ変数になります。

オプション

リモート タグの数の情報を指定する整数型タグ変数または整数の定数が、ファイルに書き込まれます。可能な値は以下のとおりです。

空の文字列 " "

この引数は今後使用するために予約されていますが、スクリプトでは IORRWriteState() 関数に含める必要があります。

結果

IORRWriteState() 関数呼び出しによってファイルに保存された情報を解釈するためのいくつかの例を以下に示します。

現在のアドレスのリスト

出力ファイルの以下の行では、完全にアクティブ化された、更新可能なリモート リファレンス タグの例を示しています。以下の行は、TestProt:di000 リモート リファレンス タグにアドレス 65535 が割り当てられていることを示しています。

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

以下のリモート リファレンス タグ名は、括弧で囲まれた 3 つのフラグです。

• 最初のフラグ R は、タグ変数のリモート リファレンスが正常に解決されたことを示します。タグ変数のリモート リファレンスがまだ保留である場合に、最初のフラグに値 X が割り当てられます。

• 2 番目のフラグは、リモート タグが現在アクティブである場合は A、アクティブでない場合は D を示します。

• 3 番目のフラグは、アドレスが許可されている場合は 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 アプリケーションが更新される、完全にアクティブ化されたリモート タグの例を示しています。

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 が表示されます。2 つの時間は、リストに最初に追加された時間、および最新のアクセス時間を表します。

例

この例では、現在のアクティブ化されているリモート タグ アドレスが、c:\intouch\data フォルダにあるファイルに書き込まれます。ReturnValue タグ変数に整数が割り当てられます。これは、関数呼び出しによってリモート タグ情報がファイルに正常に書き込まれたことを示します。

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