cniCreateElementAsFirstChildUsingParser

Crea un nuevo elemento de sintaxis como el primer hijo del elemento de sintaxis especificado y lo asocia con el nombre de clase de analizador especificado.

Una parte del árbol de elementos de sintaxis que es propiedad de un analizador sólo puede tener la raíz efectiva en la primera generación de elementos (es decir, como hijos inmediatos de la raíz). La interfaz de nodo definido por el usuario no restringe la posibilidad de crear un subárbol que parezca ser propiedad de un analizador diferente. Sin embargo, no es posible serializar estos árboles de elementos en una corriente de bits cuando se está emitiendo un mensaje de salida.

Si especifica el nombre de un analizador proporcionado con WebSphere Message Broker, deberá utilizar el nombre de clase correcto del analizador.

El nombre interno para el analizador BLOB es none. Por tanto, si utiliza esta función para crear una carpeta de analizador BLOB, el nombre del analizador asociado debe ser none.

Sintaxis

CciElement* cniCreateElementAsFirstChildUsingParser(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  parserClassName);

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
  • CCI_INV_PARSER_NAME
targetElement
Dirección del objeto de elemento (entrada).
parserClassName
Nombre de la clase de analizador (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
as07850_