Verwenden Sie diese Funktion, um einen Teil der Elementbaumstruktur vom Quellenelement zum Zielelement zu kopieren. 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 alle 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.
void cniCopyElementTree(
int* returnCode,
CciElement* sourceElement,
CciElement* targetElement);
Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.
cniCopyElementTree(&rc, inRootElement, outRootElement);