cniRootElement

Obtém o elemento de sintaxe raiz associado a uma mensagem especificada. Retorna o elemento raiz que é associado ao (e de propriedade do) objeto de mensagem identificado pelo parâmetro message. Quando um objeto de mensagem é construído pelo intermediário, um elemento raiz é criado automaticamente.

Sintaxe

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

Parâmetros

returnCode
O código de retorno da função (saída).
message
O endereço do objeto de mensagem (entrada).

Valores de Retorno

Se bem-sucedida, o endereço do objeto do elemento raiz é retornado. Caso contrário, zero (CCI_NULL_ADDR) é retornado e o parâmetro returnCode indica a razão do erro.

Exemplo

   inRootElement = cniRootElement(&rc, message);

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