CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Konstruktoren, Destruktor, Operatoren /

InvalidateObject - Freigabe eines CXI-Knotens

CxiError CxiNode :: InvalidateObject ()

Gibt den Speicherbereich eines CXI-Knotens oder CXI-Baums frei

InvalidateObject führt alle Aktionen des Destruktors aus und gibt bei Nicht-Alias-Objekten den gesamten Datenbereich des Blocks mit Ausnahme weniger Bytes (private Variablen des C++-Objekts) frei. Das Objekt selbst bleibt somit bestehen, es sind jedoch keine Zugriffe auf die Daten mehr möglich. Die Freigabe der restlichen Bytes kann nur mit dem Destruktor (automatisch oder mittels delete) erfolgen. InvalidateObject gibt immer cxiNoError (=0) zurück.

Mehrfacher Aufruf von InvalidateObject für das gleiche Objekt wird abgefangen, uninitialisierte CXI-Objekte werden erkannt.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar. Der alte Name Invalidate für diese Funktion wird noch unterstützt, sollte jedoch ab Version 2.07 nicht mehr verwendet werden, da Probleme mit anderen Bibliotheken (Oberflächentools) auftreten können.

Siehe auch:
~CxiNode() - Destruktor
DeleteCxiNode - Freigabe eines CxiHandle