WebSphere Message Brokers
File: as07800_
Writer: Lorraine Waitt

Reference topic

This build: July 31, 2007 21:37:32

cniCreateElementAfter

Creates a new syntax element and inserts it after the specified syntax element. The new element becomes the next sibling of the specified element.

cniCreateElementAfter should not be used when creating a message body folder (such as XML, XMLNS, MRM, BLOB), because it does not associate an owning parser with the folder. To create a message body folder, you can use any of the following functions:
   cniCreateElementAsFirstChildUsingParser
   cniCreateElementAsLastChildUsingParser
   cniCreateElementAfterUsingParser
   cniCreateElementBeforeUsingParser
When the message body folder has been created, cniCreateElementAfter can be used to create elements under the folder. cniCreateElementAfter can be used 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.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:37:32

as07800_ This topic's URL is: