cniCreateElementAsLastChild

Crea un nuovo elemento di sintassi come ultimo child dell'elemento di sintassi specificato.

cniCreateElementAsLastChild non deve essere utilizzato quando si crea una cartella di contenuto del messaggio (come XML, XMLNS, MRM, BLOB), in quando non esegue l'associazione di un programma di analisi di proprietà con la cartella. Per creare una cartella di contenuto del messaggio, è possibile utilizzare una delle seguenti funzioni:
   cniCreateElementAsFirstChildUsingParser
   cniCreateElementAsLastChildUsingParser
   cniCreateElementAfterUsingParser
   cniCreateElementBeforeUsingParser
Una volta creata tale cartella, è possibile utilizzare cniCreateElementAsLastChild per creare elementi sotto di essa. E' possibile utilizzare cniCreateElementAsLastChild in quanto viene ereditato il programma di analisi associato alla cartella di contenuto del messaggio.

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
L'indirizzo dell'oggetto elemento (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

    CciElement* lastChild = cniCreateElementAsLastChild(&rc, outRootElement);
    cniSetElementName(&rc, lastChild, elementName);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07860_