cniFirstChild

Retorna o endereço do objeto do elemento de sintaxe que é o primeiro filho do elemento de sintaxe especificado.

Sintaxe

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

Parâmetros

returnCode
O código de retorno da função (saída).
targetElement
O endereço do objeto do elemento de sintaxe de destino (entrada).

Valores de Retorno

  • Se bem-sucedida, o endereço do objeto de elemento de sintaxe pedido é retornado.
  • Se não houver um primeiro filho, zero é retornado e returnCode é definido como CCI_SUCCESS.
  • Se um erro ocorrer, zero (CCI_NULL_ADDR) é retornado e o parâmetro returnCode indica a razão do erro.

Exemplo

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

Conceitos relacionados
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniLastChild
cniNextSibling
cniParent
cniPreviousSibling
cniRootElement
Grupo cniSearchElement