cniCreateElementAsFirstChild

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

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

Sintaxe

CciElement* cniCreateElementAsFirstChild(
    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
as07840_