cniCreateElementAsLastChildUsingParser

Esta función crea un nuevo elemento de sintaxis como último elemento dependiente del elemento de sintaxis especificado, y lo asocia con el nombre de clase de analizador especificado.

Una parte del árbol de elementos de sintaxis que pertenece a un analizador sólo puede tener su raíz efectiva en la primera generación de elementos (es decir, como elementos dependientes inmediatos de la raíz). La interfaz de nodo definida por el usuario no restringe la capacidad de crear un subárbol cuyo propietario parezca ser otro analizador. No obstante, no es posible serializar estos árboles de elementos en una corriente de bits al enviar un mensaje.

Si especifica el nombre de un analizador suministrado con WebSphere Business Integration Message Broker, debe utilizar el nombre de clase correcto del analizador. Consulte el apartado Funciones de implementación de nodo de lenguaje C para obtener una lista de los analizadores suministrados.

Sintaxis

CciElement* cniCreateElementAsLastChildUsingParser(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  parserClassName);

Parámetros

returnCode
Código de retorno de la función (salida).
targetElement
Dirección del objeto de elemento (entrada).
parserClassName
Nombre de la clase de analizador (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del nuevo objeto de elemento. De lo contrario, se devuelve el valor cero (CCI_NULL_ADDR), y el parámetro returnCode indica la causa del error.

Ejemplo

    cniElementName(&rc, firstChild, elementName);
    CciElementType type = cniElementType(&rc, firstChild);
    CciElement* lastChild = cniCreateElementAsLastChildUsingParser(
                                                                  &rc, 
                                                                  outRootElement, 
                                                                  parserName);
    cniSetElementName(&rc, lastChild, elementName);
    cniSetElementType(&rc, lastChild, elementType);

Conceptos relacionados
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
Funciones de implementación de nodo de lenguaje C
cniCreateElementAsFirstChild
cniCreateElementAsFirstChildUsingParser
cniCreateElementAsLastChild
cniCreateElementAsLastChildFromBitstream