Use esta função para criar um novo elemento da sintaxe e insira-o antes do elemento da sintaxe especificado. O novo elemento se torna o irmão anterior do elemento especificado, e compartilha o mesmo elemento pai.
NÃO use cniCreateElementBefore ao criar uma pasta de corpo da mensagem (tal como XML, XMLNS, MRM, BLOB), porque isto não associa um analisador de propriedade à pasta. Para criar uma pasta de corpo da mensagem, é possível usar uma das funções a seguir:
Quando a pasta do corpo da mensagem tiver sido criada, cniCreateElementBefore poderá ser utilizado para criar elementos sob a pasta. cniCreateElementBefore pode ser utilizado porque o analisador, que está associado à pasta do corpo da mensagem, é herdado.
CciElement* cniCreateElementBefore(
int* returnCode,
CciElement* targetElement);
Se for bem-sucedido, o endereço do novo objeto de elemento é retornado. Caso contrário, um valor de zero (CCI_NULL_ADDR) é retornado, e o parâmetro returnCode indica a razão do erro.