Use this function to create a syntax element as the first child of the specified syntax element, and associates it with the specified parser class name.
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 a 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.
CciElement* cniCreateElementAsFirstChildUsingParser(
int* returnCode,
CciElement* targetElement,
const CciChar* parserClassName);
If successful, the address of the new element object is returned. Otherwise, a value of zero (CCI_NULL_ADDR) is returned, and the returnCode parameter indicates the reason for the error.