cniCopyElementTree

Kopiert einen Teil der Elementbaumstruktur vom Quellenelement zum Zielelement. Es werden nur die untergeordneten Elemente des Quellenelements kopiert. Alle vorhandenen untergeordneten Elemente des Zielelements werden gelöscht und durch die untergeordneten Elemente des Quellenelements ersetzt.

Wenn das Zielelement nicht komplett analysiert wurde oder einen nicht analysierten Bitstrom darstellt, führt die Funktion cniCopyElementTree zum Parsen des Zielelements, bevor dessen untergeordneten Elemente abgehängt werden. Somit stellt die Funktion Konsistenz bei der Nachrichtenbaumstruktur sicher, damit jegliche Verweise zu abgehängten Feldern von cciElements gültig bleiben. Wenn während der Ausführung der Funktion cniCopyElementTree eine Parsing-Ausnahmebedingung auftritt, kann deshalb die Ursache möglicherweise auf ein Problem mit dem Ziel- oder Quellenelement zurückzuführen sein.

Syntax

void cniCopyElementTree(
  int*         returnCode,
  CciElement*  sourceElement,
  CciElement*  targetElement);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
sourceElement
Die Adresse des Quellensyntaxelementobjekts (Eingabe).
targetElement
Die Adresse des Zielsyntaxelementobjekts (Eingabe).

Rückgabewerte

Keine. Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür an.

Beispiel

  cniCopyElementTree(&rc, inRootElement, outRootElement);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:57

as07790_