Beckhoff TwinCAT 2 Automation Interface

12 Fehlercodes dokumentiert

E_ACCESSDENIED

Zugriff verweigert

Der Vorgang ist fehlgeschlagen aufgrund unzureichender Berechtigungen oder einer gesperrten Ressource. Dies tritt auf, wenn das aktuelle Dokument in der system manager instance gesperrt ist (z.B. beim Aufruf von NewConfiguration() oder OpenConfiguration()), weil eine Referenz auf das system manager's object oder ein tree element geöffnet ist. Für DeleteChild() bedeutet dies, dass das Löschen des child item aufgrund von Schutz- oder betrieblichen Einschränkungen nicht erlaubt ist.

E_FAIL

Allgemeine Funktionsstörung

Der Vorgang ist aus einem nicht näher bezeichneten Grund fehlgeschlagen und weist auf eine allgemeine Störung hin. Dies könnte während NewConfiguration() oder ActivateConfiguration(), StartRestartTwinCAT() passieren, wenn das TwinCAT-System nicht gestartet werden kann, oder ConsumeXml(), wenn der bereitgestellte XML-String kein gültiges Dokument ist.

E_INVALIDARG

Ungültiges Argument angegeben

Der Funktion wurde ein ungültiges Argument übergeben. Für OpenConfiguration() verweist der bstrFile-Pfad nicht auf eine gültige TwinCAT-Konfigurationsdatei. Für SaveConfiguration() ist der bstrFile-Pfad zum Speichern ungültig. Für LinkVariables() stimmen die Parameter offs1, offs2 oder size nicht mit der Struktur oder dem Bereich der Variablen überein.

E_NOTSUPPORTED

Vorgang im aktuellen Modus nicht unterstützt

Der versuchte Vorgang, insbesondere NewConfiguration(), OpenConfiguration() oder SaveConfiguration(), wird im aktuellen Betriebsmodus des TwinCAT Automation Interface nicht unterstützt. Diese Methoden sind ausschließlich verfügbar, wenn das Automation Interface im Kompatibilitätsmodus läuft.

E_POINTER

Invalid Pointer

Ein "Invalid Pointer" wurde der Funktion übergeben. Für "ProduceXml()" bezieht sich dies auf den "output pXML parameter", was darauf hinweist, dass die Variable zum Speichern des "XML string" nicht korrekt "allocated" ist. Für "CreateChild()" bedeutet dies, dass der "pipItem pointer", der die "interface" des neuen Kindelements empfangen soll, "invalid" ist, wodurch die erfolgreiche Erstellung und Rückgabe des Kindelements verhindert wird.

NTE_BAD_SIGNATURE

Ungültige Importdateisignatur

Die für den Import angegebene Datei enthält kein gültiges Tree-Item oder weist eine beschädigte Signatur auf (0x80090006). Dieser Fehler tritt auf, wenn ImportChild() versucht, die Datei zu lesen, aber feststellt, dass ihr Inhalt kein anerkanntes TwinCAT Tree-Item Exportformat ist.

NTE_NOT_FOUND

Importdatei nicht gefunden

Die angegebene Datei zum Importieren eines untergeordneten Elements konnte nicht gefunden oder geöffnet werden (0x80090011). Dies deutet auf ein Problem mit dem Pfad zur Importdatei oder deren Zugänglichkeit hin, was den Abschluss des ImportChild()-Vorgangs verhindert.

TSM_E_CORRUPTEDLINK

Beschädigter Variablenlink

Die angegebenen Variablen können nicht entknüpft werden, möglicherweise aufgrund einer beschädigten oder ungültigen Link-Definition in der TwinCAT-Konfiguration (0x98510005). Dies deutet auf ein Problem mit der Integrität der Variablenverknüpfungsdaten innerhalb des Systems hin.

TSM_E_INVALIDITEMSUBTYPE

Ungültiger Element-Untertyp für Erstellung

Der angegebene nSubType Parameter zum Erstellen eines untergeordneten Elements ist ungültig oder nicht kompatibel mit dem Typ des übergeordneten Elements (0x98510003). Der nutzbare subType hängt von der Kategorie des übergeordneten Baum-Elements ab; zum Beispiel kann ein PLC Functionblock nur einem PLCFOLDER Element hinzugefügt werden, nicht einem DEVICE Element.

TSM_E_INVALIDITEMTYPE

Ungültiger Baumobjekttyp für den Vorgang

Eines oder beide der angegebenen Baumobjekte sind für den versuchten Vorgang ungültig (0x98510002). Für LinkVariables() oder UnlinkVariables() bedeutet dies, dass eines oder beide Baumobjekte nicht vom Variablentyp sind, was Verknüpfungsvorgänge verhindert.

TSM_E_ITEMNOTFOUND

TwinCAT Baumobjekt nicht gefunden

Das angegebene Baumobjekt konnte mit dem bereitgestellten Bezeichner (0x98510001) nicht gefunden werden. Dies kann bei LookupTreeItem() (absoluter Pfadname), LookupTreeItemById() (itemType/itemId-Kombination), LookupChild() (relativer Pfadname), CreateChild() (bstrBefore-Objekt nicht gefunden), DeleteChild() (bstrName-Objekt nicht gefunden), ExportChild() (bstrName-Objekt nicht gefunden) oder ChangeChildSubType() (bstrChild-Objekt nicht gefunden) auftreten.

TSM_E_MISMATCHINGITEMS

Nicht übereinstimmende Elemente für den Betrieb

Die am Vorgang beteiligten Elemente sind inkompatibel (0x98510004). Für LinkVariables() tritt dies auf, wenn zwei Variablen aufgrund inkompatibler Datentypen nicht verknüpft werden können, ein Versuch unternommen wird, zwei Ausgänge zu verknüpfen, ein Ausgang einer Aufgabe mit einem Eingang eines Geräts verknüpft wird oder Variablen desselben Besitzers verknüpft werden. Für ImportChild() bedeutet dies, dass das in der Importdatei enthaltene Baum-Element kein gültiges untergeordnetes Element für das aktuelle übergeordnete Element ist oder seine Struktur inkompatibel ist.