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 */
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07590_