cniCreateElementAsLastChild

Diese Funktion erstellt ein neues Syntaxelement als letztes untergeordnetes Element des angegebenen Syntaxelements.

cniCreateElementAsLastChild 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 cniCreateElementAsLastChild verwenden, um Elemente im Ordner zu erstellen. cniCreateElementAsLastChild kann verwendet werden, da der Parser, der dem Ordner für den Nachrichtenhauptteil zugeordnet ist, übernommen wird.

Syntax

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

Parameter

returnCode
Der Rückkehrcode aus 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 erfolgreicher Ausführung wird die Adresse des neuen Elementobjekts zurückgegeben. Andernfalls wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter returnCode gibt die Fehlerursache an.

Beispiel

    CciElement* lastChild = cniCreateElementAsLastChild(&rc, outRootElement);
    cniSetElementName(&rc, lastChild, elementName);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07860_