HRESULT

Die meisten Methoden der TwinCAT 3 Plastic Technology Functions geben Informationen über den Erfolg der Ausführung mittels eines HRESULT Wertes zurück. Dieser bildet sich aus einzelnen 16 Informations-Bits und einem 16-Bit Error code. In Summe ergibt sich der 32 Bit Datentyp. Der Grundaufbau folgt dem folgenden Schema:

Bits	31	30-16	15-0
Bedeutung	0 = Erfolg, 1 = Error	Charakteristische Kennung der Plastic Technology Functions: 0x1B00	Fehlercode: Typischerweise übereinstimmend mit der Aufzählung E_AdsErr

Zur Auswertung eines HRESULT Fehlercodes bieten sich mehrere Möglichkeiten an:

Grundlegend bietet die Tc3_Module Bibliothek simple Funktionen zur Überprüfung.

SUCCEEDED() --> Erfolg
FAILED() --> Fehlschlag

Da der HRESULT-Datentyp vorzeichenbehaftet ist, kann das Bit 31 auch durch einen größer/kleiner Vergleich überprüft werden.

>= 0 --> Erfolg
< 0 --> Fehlschlag

Die Funktion F_SucceededHr(…) verbindet zwei Vorgänge der Fehlercodeauswertung miteinander.

Die Funktion selbst gibt ein boolesches TRUE zurück, wenn der HRESULT Wert einen Erfolg anzeigt.
Sollte der HRESULT einen Fehlschlag anzeigen, wird die Information in die übergebene Destination variable kopiert.

Sehen Sie dazu auch PLC Programmierungskonventionen – Fehler Codes

Weiterführende Informationen