Esta función crea un nuevo árbol de elementos de sintaxis como último elemento dependiente del elemento de sintaxis especificado, y lo asocia con el analizador especificado. El nuevo árbol de elementos de sintaxis se llena mediante el análisis de la corriente de bits especificada. Durante la ejecución de esta función, se copia la corriente de bits para que el canal de llamada pueda liberar o reutilizar la memoria asignada para retener la corriente de bits original. Sólo puede utilizar esta función para crear un cuerpo de mensaje, es decir, el último elemento dependiente de la raíz del mensaje. Deberá existir ya un mensaje de salida. El elemento raíz de este mensaje de salida deberá pasarse como parámetro de elemento de destino. Puesto que esta llamada sólo está diseñada para crear un cuerpo de mensaje, el usuario no podrá utilizarla para crear elementos sucesivos. Por ejemplo, no debe utilizarse para crear un elemento RFH2 como último elemento dependiente de la raíz y, a continuación, un mensaje XML como último elemento dependiente de la raíz, después de haber creado el elemento 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);
Si la función se ejecuta correctamente, se devuelve la dirección del nuevo objeto de elemento. De lo contrario, se devuelve el valor cero (CCI_NULL_ADDR), y el parámetro de código de retorno indica la causa del error. Si se produce una excepción durante la ejecución, returnCode se establece en CCI_EXCEPTION.
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; }
Conceptos relacionados
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario
Tareas relacionadas
Creación de un nodo de proceso de mensajes en C
Referencia relacionada
cciGetLastExceptionData
cniCreateElementAsFirstChild
cniCreateElementAsFirstChildUsingParser
cniCreateElementAsLastChild
cniCreateElementAsLastChildUsingParser
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
as07865_ |