cniCreateElementAfterUsingParser

Use this function to create a syntax element, insert it after the specified syntax element, and associate it with the specified parser class name. The new element becomes the next sibling of the specified element.

A portion of the syntax element tree that is owned by a parser can only have its effective root at the first generation of elements (that is, as immediate children of root). The user-defined node interface does not restrict the ability to create a subtree that appears to be owned by a different parser. However, it is not possible to serialize these element trees into a bit stream when producing an output message.

If you specify the name of a parser supplied with IBM® Integration Bus, you must use the correct class name of the parser.

The internal name for the BLOB parser is none. Therefore, if you use this function to create a BLOB parser folder, the associated parser name should be none.

Syntax

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

Parameters

returnCode
The return code from the function (output).
Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_PARSER_NAME
TargetElement
The address of the element object (input).
parserClassName
The name of the parser class (input).