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).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
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 */
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07590_