Verwenden Sie diese Funktion, um ein Syntaxelement als letztes untergeordnetes Element des angegebenen Syntaxelements zu erstellen.
Verwenden Sie cniCreateElementAsLastChild nicht bei der Erstellung eines Ordners für den Nachrichtenhauptteil (wie beispielsweise XML, XMLNS, MRM, BLOB), da diese Funktion dem Ordner keinen Eignerparser zuordnet. Verwenden Sie hierfür eine der folgenden Funktionen:
Wenn der Ordner für den Nachrichtenhauptteil erstellt wurde, können Sie cniCreateElementAsLastChild verwenden, um Elemente im Ordner zu erstellen. Sie können cniCreateElementAsLastChild verwenden, da der Parser, der dem Ordner für den Nachrichtenhauptteil zugeordnet ist, übernommen wird.
CciElement* cniCreateElementAsLastChild(
int* returnCode,
CciElement* targetElement);
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.
CciElement* lastChild = cniCreateElementAsLastChild(&rc, outRootElement);
cniSetElementName(&rc, lastChild, elementName);