WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

cniCreateElementAsFirstChild

Use this function to create a syntax element as the first child of the specified syntax element.

Do not use cniCreateElementAsFirstChild 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 one of the following functions:

  • cniCreateElementAsFirstChildUsingParser
  • cniCreateElementAsLastChildUsingParser
  • cniCreateElementAfterUsingParser
  • cniCreateElementBeforeUsingParser

When the message body folder has been created, you can call cniCreateElementAsFirstChild to create elements under the folder. You can use cniCreateElementAsFirstChild because the parser, which is associated with the message body folder, is inherited.

Syntax

CciElement* cniCreateElementAsFirstChild(
  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, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:29


Reference topicReference topic | Version 8.0.0.7 | as07840_