IORRGetSystemInfo() 関数IORRGetSystemInfo()かんすう
- Last UpdatedSep 26, 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);