WebSphere Message Brokers
File: as07720_
Writer: Lorraine Waitt

Reference topic

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

cniFirstChild

Returns the address of the syntax element object that is the first child of the specified syntax element.

Syntax

CciElement* cniFirstChild(
  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 target syntax element object (input).

Return values

  • If successful, the address of the requested syntax element object is returned.
  • If there is no first child, zero is returned, and returnCode is set to CCI_SUCCESS.
  • If an error occurs, zero (CCI_NULL_ADDR) is returned, and the returnCode parameter indicates the reason for the error.

Example

  if (element != 0) {
    cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
    firstChild = cniFirstChild(&rc, element);
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:26

as07720_ This topic's URL is: