cniCreateElementAfter

Cria um novo elemento de sintaxe e o insere após o elemento de sintaxe especificado. O novo elemento se torna o próximo irmão do elemento especificado.

cniCreateElementAfter 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, cniCreateElementAfter poderá ser utilizado para criar elementos sob a pasta. cniCreateElementAfter pode ser utilizado porque o analisador, que está associado à pasta do corpo da mensagem, é herdado.

Sintaxe

CciElement* cniCreateElementAfter(
    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 de zero (CCI_NULL_ADDR) é retornado, e o parâmetro returnCode indica a razão do erro.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07800_