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).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
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);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07680_