Valori e codici di ritorno delle funzioni di utilità

Per convenzione, il parametro di output del codice di ritorno di tutte le funzioni di utilità è impostato per indicare che il completamento ha avuto esito positivo o diversamente. Nella tabella riportata di seguito sono presenti tutti i codici di ritorno con il relativo significato. Tali codici di ritorno sono definiti nel file d'intestazione BipCci.h.

Tabella 1. Valori e codici di ritorno delle funzioni di utilità
Codice di ritorno Spiegazione
CCI_BUFFER_TOO_SMALL Il buffer di output non è grande a sufficienza per contenere i dati richiesti.
CCI_EXCEPTION Si è verificata un'eccezione.
CCI_EXCEPTION_CONFIGURATION Nel richiamare la funzione è stata rilevata un'eccezione di configurazione. 1
CCI_EXCEPTION_CONVERSION Nel richiamare la funzione è stata rilevata un'eccezione di conversione. 1
CCI_EXCEPTION_DATABASE Nel richiamare la funzione è stata rilevata un'eccezione di database.
CCI_EXCEPTION_FATAL Nel richiamare la funzione è stata rilevata un'eccezione grave. 1
CCI_EXCEPTION_PARSER Nel richiamare la funzione è stata rilevata un'eccezione del programma di analisi. 1
CCI_EXCEPTION_RECOVERABLE Nel richiamare la funzione è stata rilevata un'eccezione recuperabile. 1
CCI_EXCEPTION_UNKNOWN E' stata specificata o rilevata un'eccezione sconosciuta.
CCI_EXCEPTION_USER Nel richiamare la funzione è stata rilevata un'eccezione utente. 1
CCI_FAILURE Una funzione non ha avuto esito positivo.
CCI_FAILURE_CONTINUE Valore di restituzione cniRun(): esecuzione rollback dell'elaborazione messaggi e prosecuzione dell'esecuzione del thread
CCI_FAILURE_RETURN Valore di restituzione cniRun(): esecuzione rollback dell'elaborazione messaggi e restituzione del thread al pool
CCI_INV_CODEPAGE È stato specificato un numero di code page non valido.
CCI_INV_CHARACTER E' stato rilevato un carattere non valido nel buffer da convertire.
CCI_INV_DATA_BUFLEN È stato specificato 0 come lunghezza del buffer dei dati.
CCI_INV_DATA_POINTER E' stato specificato un puntatore nullo per l'indirizzo di un'area dei dati di output.
CCI_INV_ELEMENT_OBJECT E' stato specificato un puntatore nullo per l'oggetto elemento.
CCI_INV_FACTORY_NAME E' stato specificato un nome di produttore non valido (vuoto).
CCI_INV_FACTORY_OBJECT E' stato specificato un puntatore nullo per l'oggetto produttore.
CCI_INV_IMPL_FUNCTION E' stata specificata una combinazione non valida di funzioni di implementazione di condizione.
CCI_INV_LENGTH È stato specificato 0 come lunghezza.
CCI_INV_LOG_TYPE Il tipo di registrazione specificato non è valido.
CCI_INV_MESSAGE_CONTEXT E' stato specificato un puntatore nullo per il contesto del messaggio.
CCI_INV_MESSAGE_OBJECT E' stato specificato un puntatore nullo per l'oggetto messaggio.
CCI_INV_NODE_ENV Tentativo di inviare un thread da un nodo non di input.
CCI_INV_NODE_NAME E' stato specificato un nome di nodo non valido (vuoto).
CCI_INV_NODE_OBJECT E' stato specificato un puntatore nullo per l'oggetto nodo.
CCI_INV_OBJECT_NAME I caratteri specificati nel nome dell'oggetto non sono validi.
CCI_INV_PARSER_NAME E' stato specificato un nome di classe non valido (vuoto).
CCI_INV_PARSER_OBJECT E' stato specificato un puntatore nullo per l'oggetto programma di analisi.
CCI_INV_SQL_EXPR_OBJECT E' stato specificato un puntatore nullo per un valore di espressione SQL.
CCI_INV_STATEMENT Non è stata specificata un'istruzione.
CCI_INV_TERMINAL_NAME E' stato specificato un nome di terminale non valido (vuoto).
CCI_INV_TERMINAL_OBJECT E' stato specificato un puntatore nullo per l'oggetto terminale.
CCI_INV_TRANSACTION_TYPE E' stato specificato un valore non valido per il tipo di transazione.
CCI_INV_VFTP E' stato specificato un puntatore nullo per l'indirizzo della tabella del puntatore della funzione virtuale dell'estensione definita dall'utente.
CCI_MISSING_IMPL_FUNCTION Nella tabella del puntatore della funzione non è stata definita una funzione di implementazione obbligatoria.
CCI_NAME_EXISTS Già esiste un programma di analisi con lo stesso nome di classe.
CCI_NO_BUFFER_EXISTS Non esiste alcun buffer per l'oggetto programma di analisi specificato.
CCI_NO_EXCEPTION_EXISTS Non è stata rilevata alcuna eccezione precedente per questo thread.
CCI_NO_THREADS_AVAILABLE Non erano disponibili thread da inviare.
CCI_NULL_ADDR Non ha avuto esito positivo una funzione che doveva restituire un indirizzo; viene quindi restituito il valore zero.
CCI_PARSER_NAME_TOO_LONG Il nome della classe del programma di analisi è troppo lungo.
CCI_SUCCESS Completamento con esito positivo.
CCI_SUCCESS_CONTINUE Valore di restituzione cniRun(): esecuzione commit dell'elaborazione messaggi e prosecuzione dell'esecuzione del thread
CCI_SUCCESS_RETURN Valore di restituzione cniRun(): esecuzione commit dell'elaborazione messaggi e restituzione del thread al pool
CCI_TIMEOUT Valore di restituzione cniRun(): mancata esecuzione dell'elaborazione messaggi, ma prosecuzione dell'esecuzione del thread
Nota:
  1. Questo codice di ritorno viene restituito solo da cniGetLastExceptionData ad indicare il tipo dell'ultima eccezione.
Riferimenti correlati
Funzioni di utilità comune di C
File di intestazione
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08557_