Diese Funktion erstellt eine neue Syntaxelementstruktur als letztes untergeordnetes Element des angegebenen Syntaxelements und ordnet sie dem angegebenen Parser zu. 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. Sie können mit dieser Funktion nur den Nachrichtenhauptteil, d. h. das letzte untergeordnete Element des Nachrichtenstamms erstellen. Eine Ausgabenachricht sollte bereits vorhanden sein. Das Stammelement dieser Ausgabenachricht sollte als Zielelementparameter übergeben werden. Da dieser Aufruf nur für die Erstellung eines Nachrichtenhauptteils bestimmt ist, können Sie damit keine aufeinander folgenden Elemente erstellen. Er sollte beispielsweise nicht verwendet werden, um einen RFH2 als letztes untergeordnetes Element des Stamms und anschließend eine XML-Nachricht als letztes untergeordnetes Element des Stamms nach dem RFH2 zu erstellen.
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 erfolgreicher Ausführung wird die Adresse des neuen Elementobjekts zurückgegeben. Andernfalls wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter für den Rückkehrcode gibt die Fehlerursache an. Wenn bei der Ausführung eine Ausnahmebedingung auftritt, wird als Wert für returnCode CCI_EXCEPTION festgelegt.
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; }