IORRGetSystemInfo()
- Last UpdatedSep 24, 2024
- 2 minute read
La fonction IORRGetSystemInfo() renvoie le compteur de variables d'une application InTouch en exploitation. En fonction de la valeur d'un argument, la fonction IORRGetSystemInfo() renvoie une valeur numérique, qui peut correspondre au :
-
Nombre maximum d'adresses de variables distantes spécifié par la licence InTouch.
-
Nombre d'adresses de variables distantes comptées par rapport à la licence pendant la période d'exécution d'une application InTouch.
-
Nombre de variables distantes actuellement activées dans une application InTouch.
-
Nombre de variables à distance disponibles dans une application InTouch en cours d'exécution.
-
Nombre de variables de référence distantes, qui sont actuellement désactivées.
-
Nombre de variables locales dans une application InTouch en cours d'exécution.
-
-1 en cas d'erreur pendant l'appel à la fonction, ou si la valeur de l'argument Option est invalide.
Catégorie
Autres
Syntaxe
Fonction IORRGetSystemInfo()
Argument
Option
Variable ou constante de type entier qui précise le type du compteur de références distantes à renvoyer. Les valeurs possibles comprennent :
|
1 |
Renvoie le nombre maximum autorisé d'adresses de variables distantes, en fonction de la licence InTouch. Les variables d'E/S locales n'entrent pas dans le compte des variables distantes. Ce nombre reste constant pendant l'exploitation de l'application InTouch. |
|
2 |
Renvoie le nombre d'adresses non dupliquées de variables distantes, recensées dans la limite de la licence, qui ont été activées pendant l'exploitation d'une application InTouch. Les variables d'E/S locales n'entrent pas dans le compte des variables distantes. Si la licence autorise plus de 60K variables de références distantes, ce nombre peut être 0, indépendamment du nombre d'adresses de variables distantes activées. Quand il est exploité sous une licence illimitée, WindowViewer ne compte pas les adresses de variables distantes activées. Quand une application est exploitée sous une licence limitée quant au nombre de variables distantes, ce compteur augmente jusqu'à la limite spécifiée par cette licence. Après avoir atteint la limite de variables distantes, aucune autre adresse de variable distante ne peut être activée. Seules les adresses déjà activées peuvent être réactivées. Utilisez la fonction IORRWriteState() avec l'argument Option défini à 3 pour récupérer la liste des références distantes comprises dans la limite de la licence. |
|
3 |
Renvoie le nombre de références distantes actuellement actives dans une application InTouch. |
|
4 |
Renvoie le nombre de références distantes qu'il est possible d'activer dans une application InTouch sans dépasser la limite des descripteurs de variables distantes. Ce compteur varie normalement pendant l'exploitation d'une application. Le compteur de références distantes est influencé par l'arrêt et l'exécution de scripts, ainsi que par l'ouverture et la fermeture de fenêtres contenant des références distantes. Ce nombre peut être inférieur à celui encore disponible pour la licence, en particulier pour une licence illimitée. Ce résultat s'explique en raison de la limitation interne au nombre de références distantes qu'il est possible d'activer simultanément. |
|
5 |
Renvoie le nombre de références distantes actuellement inactives dans une application InTouch. |
|
6 |
Renvoie le nombre de variables locales courantes dans l'application InTouch. |
Exemple
L'exemple suivant renvoie le nombre de références distantes recensées par rapport à la limite de la licence, pendant l'exploitation d'une application InTouch. Le compteur de références distantes renvoyé est utilisé pour renseigner la valeur de la variable RRTagCount de type entier.
RRTagCount = IORRGetSystemInfo(2);