cniCreateElementAfter

Erstellt ein neues Syntaxelement und fügt es hinter dem angegebenen Syntaxelement ein. Das neue Element wird nächstes gleichgeordnetes Element des angegebenen Elements.

cniCreateElementAfter sollte nicht bei der Erstellung eines Ordners für den Nachrichtenhauptteil (wie beispielsweise XML, XMLNS, MRM, BLOB) verwendet werden, da sie dem Ordner keinen Eignerparser zuordnet.Verwenden Sie hierfür eine der folgenden Funktionen:
   cniCreateElementAsFirstChildUsingParser   cniCreateElementAsLastChildUsingParser   cniCreateElementAfterUsingParser   cniCreateElementBeforeUsingParser
Wenn der Ordner für den Nachrichtenhauptteil erstellt wurde, können Sie cniCreateElementAfter verwenden, um Elemente im Ordner zu erstellen. cniCreateElementAfter kann verwendet werden, da der Parser, der dem Ordner für den Nachrichtenhauptteil zugeordnet ist, übernommen wird.

Syntax

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

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Die Adresse des Elementobjekts (Eingabe).

Rückgabewerte

Bei Erfolg wird die Adresse des neuen Elementobjekts zurückgegeben. Ansonsten wird ein Nullwert (CCI_NULL_ADDR) ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07800_