IOGetAccessNameStatus(), fonction
- Last UpdatedMar 13, 2018
- 1 minute read
La fonction de script IOGetAccessNameStatus() renvoie un entier pour indiquer l’état de connexion de la source d’E/S primaire, secondaire ou active d’un nom d’accès.
Normalement, la valeur renvoyée par la fonction IOGetAccessNameStatus() est associée à une variable entière. La valeur de la variable peut contrôler un lien d’affichage d’une valeur discrète, pour présenter à un opérateur l’état des sources d’E/S active, primaire ou secondaire des noms d’accès.
Catégorie
Autres
Syntaxe
Result=IOGetAccessNameStatus("NomAccès", Mode);
Arguments :
NomAccès
Le nom d’accès existant dont on retourne l’état.
Mode
La valeur attribuée à cet argument détermine lequel des noms d’accès d’une paire de basculement est consulté sur son état.
0 - État de la source d’E/S active du nom d’accès
1 - État de la source d’E/S primaire du nom d’accès
2 - État de la source d’E/S secondaire du nom d’accès
Résultats
|
Valeur renvoyée |
Description |
|---|---|
|
-1 |
Il existe une erreur de configuration dans le nom d’accès. Le nom d’accès n’existe pas ou sa source d’E/S secondaire n’est pas définie. |
|
0 |
La connexion à la source d’E/S requise n’a pas réussi. |
|
1 |
La connexion à la source d’E/S requise a réussi. |
Remarques
La fonction IOGetAccessNameStatus() est normalement utilisée dans un script pour déterminer l’état de la source d’E/S secondaire active. L’opérateur exécute le script pour vérifier l’état de la connexion secondaire avant de forcer un basculement.
Exemple
Cet exemple renvoie l’état de la source d’E/S secondaire du nom d’accès ModbusPLC1. La valeur renvoyée est associée à la variable ANStatus.
ANStatus = IOGetAccessNameStatus (« ModbusPLC1 »,2)