cniFirstChild

Devuelve la dirección del objeto de elemento de sintaxis que es el primer hijo del elemento de sintaxis especificado.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Dirección del objeto de elemento de sintaxis de destino (entrada).

Valores de retorno

  • Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del objeto de elemento de sintaxis solicitado.
  • Si no existen un primer hijo, se devuelve cero y returnCode se establece en CCI_SUCCESS.
  • Si se produce un error, se devuelve cero (CCI_NULL_ADDR) y el parámetro returnCode indica la razón del error.

Ejemplo

  if (element != 0) {
    cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
    firstChild = cniFirstChild(&rc, element);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07720_