cniFinalize

Hace que el intermediario solicite a los analizadores que soportan la característica de finalización que efectúen el proceso de finalización en el mensaje especificado. El comportamiento de este proceso es específico de cada analizador.

Si el parámetro options se establece en CCI_FINALIZE_VALIDATE, un analizador también deberá realizar el proceso de validación para asegurar que el árbol de elementos del que es propietario tiene la estructura correcta. Esto ayuda a evitar que se propaguen mensajes con árboles de elementos formados incorrectamente a otros nodos del flujo de mensajes.

Se recomienda invocar cniFinalize antes de propagar un mensaje (por ejemplo, antes de invocar cniWriteBuffer).

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
Dirección del objeto de mensaje para el que se debe finalizar el árbol de elementos (entrada).
options
Especifica distintivos de bit para identificar las opciones de finalización o validación que se deben utilizar (entrada). Este parámetro es opcional. Puede establecerlo en CCI_FINALIZE_VALIDATE.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

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

      /* Manejar errores */
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07590_