cniRootElement

Esta función obtiene el elemento de sintaxis raíz asociado con un mensaje especificado. Devuelve el elemento raíz que está asociado con el objeto de mensaje (propietario del elemento raíz) identificado por el parámetro message. Cuando el intermediario construye un objeto de mensaje, se crea automáticamente un elemento raíz.

Sintaxis

CciElement* cniRootElement(
  int*         returnCode,
  CciMessage*  message);

Parámetros

returnCode
Código de retorno de la función (salida).
message
Dirección del objeto de mensaje (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del objeto de elemento raíz. De lo contrario, se devuelve cero (CCI_NULL_ADDR), y el parámetro returnCode indica la causa del error.

Ejemplo

   inRootElement = cniRootElement(&rc, message);

Conceptos relacionados
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
cniFirstChild
cniLastChild
cniNextSibling
cniParent
cniPreviousSibling
Grupo cniSearchElement