Gets the root syntax element associated with a specified message. It returns the root element that is associated with (and owned by) the message object identified by the message parameter. When a message object is constructed by the broker, a root element is automatically created.
If successful, the address of the root element object is returned. Otherwise, zero (CCI_NULL_ADDR) is returned, and the returnCode parameter indicates the reason for the error.
inRootElement = cniRootElement(&rc, message);
Related concepts
User-defined message processing nodes
User-defined output nodes
Related tasks
Creating a message processing node in C
Related reference
C language node utility functions
cniFirstChild
cniLastChild
cniNextSibling
cniParent
cniPreviousSibling
cniSearchElement group
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
as07680_ |