cciGetLastExceptionDataW

Diese Funktion ruft Diagnoseinformationen zur letzten generierten Ausnahmebedingung ab. Informationen zu der für den aktuellen Thread zuletzt generierten Ausnahmebedingung werden in einer CCI_EXCEPTION_WIDE_ST-Ausgabestruktur zurückgegeben. Die benutzerdefinierte Erweiterung verwendet diese Funktion, um festzustellen, ob eine Fehlerbehebung erforderlich ist, wenn eine Dienstprogrammfunktion einen Fehlercode zurückgibt.

Diese Funktion können Sie aufrufen, wenn ein Dienstprogrammfunktions- oder Benutzerexit-Callback darauf hinweist, dass eine Ausnahmebedingung aufgetreten ist, indem Sie Rückkehrcode auf CCI_EXCEPTION setzen.

cciGetLastExceptionDataW() darf nur bei CCI_EXCEPTION aufgerufen werden, da diese Funktion unvorhersehbare Ergebnisse zurückgibt.

Syntax

void* cciGetLastExceptionDataW(
  int*                        returnCode,
  CCI_EXCEPTION_WIDE_ST*  exception_st);

Parameters

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_INV_DATA_POINTER
  • CCI_NO_EXCEPTION_EXISTS
  • CCI_EXCEPTION
  • CCI_EXCEPTION_UNKNOWN
  • CCI_EXCEPTION_FATAL
  • CCI_EXCEPTION_RECOVERABLE
  • CCI_EXCEPTION_CONFIGURATION
  • CCI_EXCEPTION_PARSER
  • CCI_EXCEPTION_CONVERSION
  • CCI_EXCEPTION_DATABASE
  • CCI_EXCEPTION_USER
exception_st
Gibt die Adresse einer CCI_EXCEPTION_WIDE_ST-Struktur an, die Daten zur letzten Ausnahmebedingung empfangen soll (Ausgabe). Bei dem Typwert, der in den niedrigen vier Bits des Felds exception_st.type zurückgegeben wird, handelt es sich um einen der folgenden Typwerte:
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_BASE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_TERMINATION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_FATAL
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_RECOVERABLE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_CONFIGURATION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_PARSER
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_CONVERSION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_DATABASE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_USER

Der Wert, der im Feld exception_st.messageNumber für Ausnahmen zurückgegeben wurde, die zu einer BIP-Ausnahmebedingungsnachricht führen, enthält die Nachrichtenstufe in den höhere Bytes und die BIP-Nachrichtennummer in den niedrigeren vier Bytes.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

typedef struct exception_wide_st {
  int               versionId;	    /* Identifikation der Version der Struktur */
  int               type;          /* Typ der Ausnahme */
  int               messageNumber; /* Nachrichtennummer */
  int               insertCount;   /* Anzahl von Nachrichteneinfügungen */
  CCI_STRING_ST     inserts[CCI_MAX_EXCEPTION_INSERTS];
                                   /* Array von Nachrichteneinfügebereichen */
  const char*       fileName;	    /* Quelle: Dateiname */
  int               lineNumber;	    /* Quelle: Zeilennummer in der Datei */
  const char*       functionName;  /* Quelle: Funktionsname */
  CCI_STRING_ST     traceText;	    /* Mit der Ausnahme verbundener Trace-Text */
  CCI_STRING_ST     objectName;    /* Objektname */
  CCI_STRING_ST     objectType;    /* Objekttyp */
} CCI_EXCEPTION_WIDE_ST;
char msgnumTypeStr[64];


CCI_EXCEPTION_WIDE_ST exception_st = malloc(sizeof(CCI_EXCEPTION_WIDE_ST));
int                rc = 0;
memset(&exception_st,0,sizeof(exception_st));
cciGetLastExceptionDataW(&rc, &exception_st);
sprintf(msgnumTypeStr, "MsgNum: %d Type: %d", 
(exception_st.messageNumber & 0x0ffff),
(exception_st.type & 0x0f));
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:21:42


ReferenzthemaReferenzthema | Version 8.0.0.1 | as24620_