cniRootElement

Use esta função para obter o elemento da 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

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:52


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | as07680_