cniFinalize

Faz com que o intermediário peça aos analisadores que suportam o recurso finalize que executem seu processamento de finalize na mensagem especificada. O comportamento desse processamento é específico para cada analisador.

Se o parâmetro options for definido como CCI_FINALIZE_VALIDATE, um analisador deve também executar processamento de validação para garantir que a árvore de elementos de sua propriedade tenha a estrutura correta. Isto ajuda a prevenir que mensagens com árvores de elementos formadas incorretamente sejam propagadas para outros nós no fluxo de mensagens.

Recomenda-se que cniFinalize seja chamada antes de propagar uma mensagem (por exemplo, antes de chamar cniWriteBuffer).

Sintaxe

void cniFinalize(
    int*            returnCode,
    CciMessage*        message,
    int                        options);

Parâmetros

returnCode
O código de retorno da função (saída).
message
O endereço do objeto de mensagem para o qual a árvore de elementos deve ser finalizada (entrada).
options
Especifica sinalizadores de bits para identificar as opções de finalização ou validação a serem utilizadas (entrada). Este parâmetro é opcional. Você pode defini-lo como CCI_FINALIZE_VALIDATE.

Valores de Retorno

Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Exemplo

      cniFinalize(&rc, outMsg, CCI_FINALIZE_NONE);
              retvalue = cniPropagate(
                             
&rc,
                                                          terminalObject,
                                                          destinationList,
                                                          exceptionList,
                                                          outMsg);

            /* Identificar erros */

Conceitos relacionados
Nós Input definidos pelo usuário
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniCreateMessage
cniDeleteMessage
cniGetEnvironmentMessage
cniGetMessageContext
cniPropagate
cniWriteBuffer