cniCreateElementAfter

Crea un nuevo elemento de sintaxis y lo inserta después del elemento de sintaxis especificado. El elemento nuevo se convierte en el hermano siguiente del elemento especificado.

No debe utilizarse cniCreateElementAfter al crear una carpeta de cuerpo de mensaje (por ejemplo, XML, XMLNS, MRM, BLOB), porque no asocia un analizador de su propiedad con la carpeta. Para crear una carpeta de cuerpo de mensaje, puede utilizar una de las siguientes funciones:
   cniCreateElementAsFirstChildUsingParser
   cniCreateElementAsLastChildUsingParser
   cniCreateElementAfterUsingParser
   cniCreateElementBeforeUsingParser
Una vez ha creado la carpeta de cuerpo de mensaje, puede utilizarse cniCreateElementAfter para crear elementos bajo la carpeta. Puede utilizarse cniCreateElementAfter porque el analizador, que está asociado a la carpeta de cuerpo de mensaje, es heredado.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Dirección del objeto de elemento (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del objeto de elemento nuevo. De lo contrario, se devuelve un valor de cero (CCI_NULL_ADDR) y el parámetro returnCode indica la razón del error.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07800_