Utilice esta función para crear un nuevo elemento de sintaxis e insertarlo antes del elemento de sintaxis especificado. El elemento nuevo se convierte en el hermano anterior del elemento especificado y comparte el mismo elemento padre.
No utilice cniCreateElementBefore al crear una carpeta de cuerpo de mensaje (como XML, XMLNS, MRM, BLOB), porque no asocia un analizador propietario a la carpeta. Para crear una carpeta de cuerpo de mensaje, puede utilizar una de las siguientes funciones:
Una vez ha creado la carpeta de cuerpo de mensaje, puede utilizarse cniCreateElementBefore para crear elementos bajo la carpeta. Puede utilizarse cniCreateElementBefore porque el analizador, que está asociado a la carpeta de cuerpo de mensaje, es heredado.
CciElement* cniCreateElementBefore(
int* returnCode,
CciElement* targetElement);
Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del objeto de elemento nuevo. De lo contrario, se devuelve un valor de cero (CCI_NULL_ADDR) y el parámetro returnCode indica la razón del error.