cniCreateElementAsLastChild

Cria um novo elemento de sintaxe como o último filho do elemento de sintaxe especificado.

cniCreateElementAsLastChild não deve ser utilizado ao criar uma pasta do corpo da mensagem (como XML, XMLNS, MRM, BLOB), porque ele não associa um analisador de propriedade à pasta. Para criar uma pasta do corpo da mensagem, você pode utilizar qualquer uma das seguintes funções:
   
cniCreateElementAsFirstChildUsingParser
   
cniCreateElementAsLastChildUsingParser
   
cniCreateElementAfterUsingParser
   cniCreateElementBeforeUsingParser
Quando a pasta do corpo da mensagem tiver sido criada, cniCreateElementAsLastChild poderá ser utilizado para criar elementos sob a pasta. cniCreateElementAsLastChild pode ser utilizado 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
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07860_