cniCreateElementAsFirstChild

Crea un nuevo elemento de sintaxis como el primer hijo del elemento de sintaxis especificado.

No debe utilizarse cniCreateElementAsFirstChild 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 cniCreateElementAsFirstChild para crear elementos bajo la carpeta. Puede utilizarse cniCreateElementAsFirstChild porque el analizador, que está asociado a la carpeta de cuerpo de mensaje, es heredado.

Sintaxis

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