cniFinalize

Fa sì che il broker richieda i programmi di analisi che supportano la funzione di finalizzazione per eseguire le relative elaborazioni di finalizzazione sul messaggio specificato. Il funzionamento di questa elaborazione è specifico di ogni programma di analisi.

Se il parametro options è impostato su CCI_FINALIZE_VALIDATE, un programma di analisi deve eseguire anche un'elaborazione di convalida per garantire che la struttura ad albero dell'elemento di sua proprietà, sia della struttura attuale. Ciò impedisce l'invio di messaggi con strutture ad albero di elementi composti in modo non corretto, ad altri nodi nel flusso di messaggi.

Si consiglia di richiamare cniFinalize prima di inviare un messaggio (ad esempio, prima di richiamare cniWriteBuffer).

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
L'indirizzo dell'oggetto messaggio per il quale deve essere finalizzata la struttura ad albero dell'elemento (input).
options
Specifica indicatori di bit per individuare le opzioni di finalizzazione o convalida da utilizzare (input). Questo parametro è facoltativo. E' possibile impostarlo su CCI_FINALIZE_VALIDATE.

Valori di restituzione

Nessuno. Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Esempio

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

      	 /* Gestisce gli errori */
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07590_