WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cniCopyElementTree

Utilice esta función para copiar 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 lo 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.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
sourceElement
Dirección del objeto de elemento de sintaxis de origen (entrada).
targetElement
Dirección del objeto de elemento de sintaxis de destino (entrada).

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

  cniCopyElementTree(&rc, inRootElement, outRootElement);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:23


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as07790_