Verwenden Sie diese Funktion, um ein Syntaxelement als erstes untergeordnetes Element des angegebenen Syntaxelements zu erstellen.
Verwenden Sie cniCreateElementAsFirstChild 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 cniCreateElementAsFirstChild aufrufen, um Elemente im Ordner zu erstellen. Sie können cniCreateElementAsFirstChild verwenden, da der Parser, der dem Ordner für den Nachrichtenhauptteil zugeordnet ist, übernommen wird.
CciElement* cniCreateElementAsFirstChild(
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.