cniCreateElementAsLastChild

Use esta função para criar um elemento da sintaxe como o último filho do elemento da sintaxe especificado.

Não use cniCreateElementAsLastChild ao criar uma pasta do corpo da mensagem (tais como XML, XMLNS, MRM, BLOB), porque isto não associa um analisador de propriedade à pasta. Para criar uma pasta de corpo da mensagem, é possível usar uma das funções a seguir:

Quando a pasta de corpo da mensagem tiver sido criada, será possível usar cniCreateElementAsLastChild para criar elementos na pasta. É possível usar cniCreateElementAsLastChild porque o analisador, que está associado à pasta do corpo da mensagem, é herdado.

Sintaxe

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

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_ELEMENT_OBJECT
targetElement
O endereço do objeto do elemento (entrada).

Valores de Retorno

Se for bem-sucedido, o endereço do novo objeto de elemento é retornado. Caso contrário, um valor zero (CCI_NULL_ADDR) é retornado e o parâmetro returnCode indica a razão do erro.

Exemplo:

    CciElement* lastChild = cniCreateElementAsLastChild(&rc,
outRootElement);
    cniSetElementName(&rc, lastChild, elementName);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização
        
        Última atualização : 2013-02-27 20:23:44


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.2 | as07860_