WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cniCopyElementTree

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.

Sintaxe

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

Parâmetros

returnCode
O código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
sourceElement
O endereço do objeto do elemento de sintaxe de origem (entrada).
targetElement
O endereço do objeto do elemento de sintaxe de destino (entrada).

Valores de Retorno

Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Exemplo

  cniCopyElementTree(&rc, inRootElement, outRootElement);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:22


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as07790_