IOGetAccessNameStatus (Funktion)
- Last UpdatedSep 14, 2023
- 1 minute read
Die Funktion IOGetAccessNameStatus() gibt den Status der primären, sekundären oder aktiven Quelle eines Zugriffsnamens zurück.
Den Rückgabewert dieser Funktion können Sie beispielsweise in einer entsprechenden Anzeigeverknüpfung verwenden, um dem Bediener den Status der einzelnen Quellen anzuzeigen.
Kategorie
Sonstige
Syntax
Ergebnis=IOGetAccessNameStatus("Zugriffsname", Modus);
Argumente
Zugriffsname
Ein vorhandener Zugriffsname, für den der Status der E/A-Quelle zurückgegeben werden soll.
Modus
Gibt an, für welche Quelle der Status abgefragt werden soll.
0 - Status der aktiven Datenquelle
1 - Status der Primärdatenquelle
2 - Status der Sekundärdatenquelle
Ergebnisse
|
Rückgabewert |
Beschreibung |
|---|---|
|
-1 |
Es liegt ein Konfigurationsfehler vor. Der Zugriffsname existiert nicht oder es ist keine sekundäre Quelle definiert. |
|
0 |
Verbindung zur angegebenen Quelle fehlgeschlagen |
|
1 |
Verbindung zur angegebenen Quelle erfolgreich |
Anmerkungen
Sie können diese Funktion verwenden, um den Status der gerade inaktiven Quelle abzufragen, bevor Sie manuell eine Failover-Umschaltung auslösen.
Beispiel
Im folgenden Beispiel wird der Status der Sekundärdatenquelle des Zugriffsnamens "ModbusSPS1" abgefragt. Das Ergebnis wird in die Variable ZNStatus geschrieben.
ZNStatus = IOGetAccessNameStatus ("ModbusSPS1",2)