Use esta função para copiar uma parte da árvore de elementos do elemento de origem para o elemento de destino. Somente os elementos filhos do elemento de origem são copiados. Todos os elementos filhos existentes do elemento de destino são excluídos e substituídos pelos elementos filhos do elemento de origem.
Se o elemento de destino ainda não tiver sido totalmente analisado, ou representa um fluxo de bits não analisado, a função cniCopyElementTree resultará em uma análise do elemento de destino antes de seus elementos filhos serem desconectados. A função, portanto, assegura a consistência na formatação da árvore de mensagens para que todas as referências aos campos desconectados por cciElements permaneçam válidas. Portanto, se uma exceção de análise ocorrer durante a execução da função cniCopyElementTree, a causa poderá ser um problema com o elemento de destino ou com o elemento de origem.
void cniCopyElementTree(
int* returnCode,
CciElement* sourceElement,
CciElement* targetElement);
Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.
cniCopyElementTree(&rc, inRootElement, outRootElement);