cniCreateElementAfter

Crea un nuovo elemento di sintassi e lo inserisce dopo l'elemento di sintassi specificato. Il nuovo elemento diviene l'elemento associato successivo dell'elemento specificato.

cniCreateElementAfter 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 cniCreateElementAfter per creare elementi sotto di essa. E' possibile utilizzare cniCreateElementAfter in quanto viene ereditato il programma di analisi associato alla cartella di contenuto del messaggio.

Sintassi

CciElement* cniCreateElementAfter(
  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.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07800_