Erstellt eine neue Syntaxelementbaumstruktur als letztes untergeordnetes Element des angegebenen Syntaxelements und verknüpft sie mit dem angegebenen Parser. Die neue Syntaxelementstruktur wird durch die Syntaxanalyse des angegebenen Bitstroms gefüllt. Während der Ausführung dieser Funktion wird der Bitstrom kopiert, so dass der Aufrufende den Speicher, der dem ursprünglichen Bitstrom zugeordnet ist, freigeben oder wiederverwenden kann. Diese Funktion kann nur zum Erstellen eines Nachrichtenhauptteils verwendet werden, d. h. dem letzten untergeordneten Element des Nachrichtenstamms. Eine Ausgabenachricht sollte bereits vorhanden sein. Das Stammelement dieser Ausgabenachricht sollte als Zielelementparameter übergeben werden. Da dieser Aufruf nur für das Erstellen eines Nachrichtenhauptteils konzipiert wurde, können Sie ihn nicht zum Erzeugen nachfolgender Elemene verwenden. Beispiel: Man sollte damit nicht einen RFH2 als letztes untergeordnetes Element des Stamms erstellen und anschließend eine XML-Nachricht als letztes untergeordnetes Element des Stamms hinter RFH2.
CciElement* cniCreateElementAsLastChildFromBitstream ( int* returnCode, CciElement* targetElement, const struct CciByteArray* value, const CciChar* parserClassName, CciChar* messageType, CciChar* messageSet, CciChar* messageFormat, int encoding, int ccsid, int options);
Bei Erfolg wird die Adresse des neuen Elementobjekts zurückgegeben. Ansonsten wird ein Nullwert (CCI_NULL_ADDR) ausgegeben, und der Rückkehrcode-Parameter gibt den Grund für den Fehler an. Wenn während der Ausführung eine Ausnahmebedingung auftritt, wird returnCode auf CCI_EXCEPTION gesetzt.
outMQMD = cniCreateElementAsFirstChildUsingParser(&rc, outRootElement, CciString("MQHMD",BIP_DEF_COMP_CCSID)); checkRC(rc); cniCopyElementTree(&rc, inMQMD, outMQMD); checkRC(rc); outBlobRoot = cniCreateElementAsLastChildFromBitstream( &rc, outRootElement, &bitstream, inParserClassName, messageType, messageSet, messageFormat, encoding, ccsid, 0); checkRC(rc); ... return; }