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);
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07680_