cciTransactionEventCallback

Questa è una funzione che può essere registrata come callback e viene richiamata ogni qualvolta una transazione del flusso di messaggi termina. Viene richiamata per ogni transazione del flusso di messaggi nel gruppo di esecuzione in cui è stata registrata la callback, se lo stato dell'uscita utente è attivo. La callback viene registrata fornendo un puntatore alla funzione nel campo iFpTransactionEventCallback della struttura CCI_UE_VFT passata a cciRegisterUserExit.

Sintassi

typedef void (*cciTransactionEventCallback) ( 
                                 CciDataContext* userContext,
                                 CciTransactionEventType type,
                                 CciMessage*    environment,
                                 CciNode*                inputNode);

Parametri

userContext (input)
Questo è il valore passato alla funzione cciRegisterUserExit.
type
Descrive gli eventi che si sono verificati. I valori possibili sono:
  • CCI_TRANSACTION_EVENT_COMMIT

    Una transazione è stata sottoposta a commit correttamente.

  • CCI_TRANSACTION_EVENT_ROLLBACK

    È stato eseguito il roll back della transazione.

Se la transazione è stata sottoposta a roll back a causa di un'eccezione non gestita, i dettagli di tale eccezione possono essere ottenuti chiamando cciGetLastExceptionData.
environment
Questo è un handle all'oggetto di ambiente per il flusso di messaggio corrente. Sebbene l'uscita utente possa aggiornare questo albero, essa viene eliminata dopo essere stata restituita da questa funzione, quindi tutti gli aggiornamenti vengono persi.
inputNode
Questo è un handle al nodo di input che legge il messaggio di input che ha attivato la transazione. Può essere utilizzato per richiamare funzioni tra cui cciGetNodeName, cciGetNodeType e cniGetBrokerInfo.

Valori di restituzione

Nessuno

Esempio

void myTransactionEventCallback(
                     CciDataContext* userContext,
                     CciTransactionEventType type,
                     CciMessage*    environment,
                     CciNode*                inputNode){
…
…
}
Concetti correlati
Sviluppo di uscite utente
Attività correlate
Sviluppo di un'uscita utente
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as35960_