Copia una parte del árbol de elementos del elemento de origen en el elemento de destino. Sólo se copian los elementos hijo del elemento de origen. Todos los elementos hijo existentes del elemento de destino se suprimen y se sustituyen por los elementos hijo del elemento de origen.
Si el elemento de destino no se ha analizado completamente, o representa una corriente de bits sin analizar, la función cniCopyElementTree da como resultado un análisis del elemento de destino antes de que sus elementos hijo se separen. Por tanto, la función asegura la coherencia en el formato de árbol de mensaje para que todas las referencias de cciElements a campos separados sigan siendo válidas. Por consiguiente, si se produce una excepción de análisis durante la ejecución de la función cniCopyElementTree, la causa podría ser un problema con el elemento de destino o con el elemento de origen.
void cniCopyElementTree( int* returnCode, CciElement* sourceElement, CciElement* targetElement);
Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.