cniFirstChild

Esta función devuelve la dirección del objeto de elemento de sintaxis que es el primer elemento dependiente del elemento de sintaxis especificado.

Sintaxis

CciElement* cniFirstChild(
  int*         returnCode,
  CciElement*  targetElement);

Parámetros

returnCode
Código de retorno de la función (salida).
targetElement
Dirección del objeto de elemento de sintaxis de destino (entrada).

Valores de retorno

  • Si la función se ejecuta correctamente, se devuelve la dirección del objeto de elemento de sintaxis solicitado.
  • Si no hay un primer elemento dependiente, se devuelve cero, y el parámetro returnCode se establece en CCI_SUCCESS.
  • Si se produce un error, se devuelve cero (CCI_NULL_ADDR), y el parámetro returnCode indica la causa de dicho error.

Ejemplo

  if (element != 0) {
    cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
    firstChild = cniFirstChild(&rc, element);

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
cniLastChild
cniNextSibling
cniParent
cniPreviousSibling
cniRootElement
Grupo cniSearchElement