cniCreateElementAfter
Use this function to create a new syntax element and insert it after the specified syntax element. The new element becomes the next sibling of the specified element.
Do not use cniCreateElementAfter when you create a message body folder (such as XML, XMLNS, MRM, BLOB), because this function does not associate an owning parser with the folder. To create a message body folder, you can use one of the following functions:
- cniCreateElementAsFirstChildUsingParser
- cniCreateElementAsLastChildUsingParser
- cniCreateElementAfterUsingParser
- cniCreateElementBeforeUsingParser
When the message body folder has been created, you can use cniCreateElementAfter to create elements under the folder. You can use cniCreateElementAfter because the parser, which is associated with the message body folder, is inherited.
Syntax
CciElement* cniCreateElementAfter(
int* returnCode,
CciElement* targetElement);Parameters
returnCode- The return code from the function (output).Possible return codes are:
- CCI_SUCCESS
- CCI_EXCEPTION
- CCI_INV_ELEMENT_OBJECT
targetElement- The address of the element object (input).
Return values
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.