cniCreateElementAsLastChildUsingParser

Crea un nuovo elemento di sintassi come ultimo child dell'elemento di sintassi specificato e lo associa al nome di classe del programma di analisi indicato.

Una parte della struttura ad albero dell'elemento di sintassi di proprietà di un programma di analisi può avere il relativo root valido solamente alla prima creazione degli elementi (ovvero, come child immediati di root). L'interfaccia del nodo definito dall'utente non limita la possibilità di creare una struttura ad albero secondaria che sembra di proprietà di un altro programma di analisi. Tuttavia, non è possibile serializzare tali strutture ad albero di elementi in un flusso di bit quando si esegue l'output di un messaggio.

Se si specifica il nome di un programma di analisi fornito con WebSphere Message Broker, è necessario utilizzare l'esatto nome di classe del programma di analisi. Fare riferimento a Funzioni di implementazione del nodo in C per un elenco dei programmi di analisi forniti.

Se si utilizza questa funzione per creare una cartella del programma di analisi BLOB, il nome interno del programma di analisi BLOB è none. Se si utilizza quindi questa funzione per creare una cartella del programma di analisi BLOB, il nome del programma di analisi associato deve essere none.

Il nome interno del programma di analisi BLOB è none. Se si utilizza quindi questa funzione per creare una cartella del programma di analisi BLOB, il nome del programma di analisi associato deve essere none.

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_PARSER_NAME
targetElement
L'indirizzo dell'oggetto elemento (input).
parserClassName
Il nome della classe del programma di analisi (input).

Valori di restituzione

Se ha esito positivo, viene restituito l'indirizzo del nuovo oggetto elemento. Altrimenti, viene restituito un valore zero (CCI_NULL_ADDR) e il parametro returnCode indica il motivo dell'errore.

Esempio

    cniElementName(&rc, firstChild, elementName);
    CciElementType type = cniElementType(&rc, firstChild);
    CciElement* lastChild = cniCreateElementAsLastChildUsingParser(
                                                                  &rc, 
                                                                  outRootElement, 
                                                                  parserName);
    cniSetElementName(&rc, lastChild, elementName);
    cniSetElementType(&rc, lastChild, elementType);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07870_