Funktion „Variable handle by name“
Index-Gruppe: IdxGrp = 0x122300 + Kanal_ID
Index-Offset: IdxOffs = 0x46
Handle über Namen | Übergibt das zum Variablennamen gehörende Handle für den Zugriff auf die Variable. Bei achsspezifischen Variablen ist das Handle abhängig vom Platz (Achsindex) der Achse, an der sie aktuell im Kanal einsortiert ist. Wird die Achse daher durch Achstausch auf einen anderen Achsindex gelegt, muss das Handle erneut ermittelt werden. Bei Strukturen wie eigendefinierte V.E.-Variablen muss der Name des Strukturelements angegeben werden. Die Struktur wird in Einzelelemente aufgelöst. |
Hinweis
Das Handle ist nur zur Laufzeit der Steuerung gültig. Es muss bei einem Neustart der Steuerung erneut gelesen werden.
Übergabeparameter (hier mit Angabe des Stream-Offsets):
0 |
Variablenname mit Nullterminierung |
wobei
Inhalt | Typ | Größe |
Variablenname (mit Instanzkennung bei achsspezifischen Variablen) | STRING | variabel, max. 256 Byte |
=> Streamlänge max. 256 Byte
Rückgabewert (hier mit Angabe des Stream-Offsets):
0 |
Handle auf die Variable |
wobei
Inhalt | Typ | Größe |
Handle auf die Variable | UNS32 | fest, max. 4 Byte |
=> Streamlänge max. 4 Byte
Anwendungsbeispiele
Übergabeparameter:
V.E.vartest | 0 |
V.E.vartest Name der Variable
0 Nullterminierung
Rückgabewert:
0x2000004 |
0x2000004 Handle der angeforderten V.E.Variablen