Verwenden Sie diese Funktion, um ein neues Syntaxelement zu erstellen und vor dem angegebenen Syntaxelement einzufügen. Das neue Element wird vorheriges gleichgeordnetes Element des angegebenen Elements und hat das gleiche übergeordnete Element.
Verwenden Sie cniCreateElementBefore 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 cniCreateElementBefore verwenden, um Elemente im Ordner zu erstellen. cniCreateElementBefore kann verwendet werden, da der Parser, der dem Ordner für den Nachrichtenhauptteil zugeordnet ist, übernommen wird.
CciElement* cniCreateElementBefore(
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.