cniCreateElementBefore

Cria um novo elemento de sintaxe e o insere antes do elemento de sintaxe especificado. O novo elemento se torna o irmão anterior do elemento especificado, e compartilha o mesmo elemento pai.

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

Sintaxe

CciElement* cniCreateElementBefore(
    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 de destino (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
as07820_