cciThrowException

Löst eine Ausnahmebedingung aus. Die Ausnahmebedingung wird durch die Nachrichtenbrokerschnittstelle ausgelöst, die die angegebenen Argumente als Ausnahmedaten verwendet.

Syntax

void cciThrowException(
  int*                Rückkehrcode,
  CCI_EXCEPTION_TYPE  Typ,
  char*               Datei,
  int                 Zeile,
  char*               Funktion,
  CciChar*            Nachrichtenquelle,
  int                 Nachrichtennummer,
  char*               Tracetext,
                      ...);

Parameter

Rückkehrcode
Der Rückkehrcode aus der Funktion (Ausgabe). Der mögliche Rückkehrcode lautet CCI_INV_DATA_POINTER.
Typ
Der Typ der Ausnahmebedingung (Eingabe). Gültige Werte sind:
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
Datei
Der Name der Quellendatei, mit der die Ausnahmebedingung generiert wurde (Eingabe). Der Wert ist optional, aber nützlich für Debugzwecke.
Zeile
Die Anzahl der Zeilen in der Quellendatei, mit der die Ausnahmebedingung generiert wurde (Eingabe). Der Wert ist optional, aber nützlich für Debugzwecke.
Funktion
Der Funktionsname, der die Ausnahmebedingung generiert hat (Eingabe). Der Wert ist optional, aber nützlich für Debugzwecke.
Nachrichtenquelle
Eine Zeichenfolge, die die Windows-Nachrichtenquelle oder den Linux- und UNIX-Nachrichtenkatalog angibt.
Nachrichtennummer
Die Nachrichtennummer, die die Ausnahmebedingung bezeichnet (Eingabe). Wenn die Nachrichtennummer null ist, wird vorausgesetzt, dass keine Nachricht verfügbar ist. Wenn die Nachrichtennummer ungleich null ist, wird die angegebene Nachricht mit allen Einfügungen, die in der Argumentenliste für Variablen bereitgestellt werden, in das Brokerereignisprotokoll geschrieben.
Tracetext
Trace-Informationen, die in das Broker-Service-Traceprotokoll geschrieben werden (Eingabe). Die Informationen sind optional, aber nützlich für Debugzwecke.
...
Eine Argumentenliste für C-Variablen, die alle Nachrichteneinfügungen, die die Nachricht begleiten, enthält (Eingabe). Diese Einfügungen werden als Zeichenfolgen behandelt, und es wird vorausgesetzt, dass die Variablenargumente den Typ pointer to char haben.
Anmerkung: char*-Zeichen müssen Zeichenfolgen in ASCII (Latin) oder EBCDIC (1047) sein.
Anmerkung: Das letzte Argument in dieser Liste muss (char*)0 sein.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter Rückkehrcode den Grund für den Fehler an.

Zugehörige Konzepte
Benutzerdefinierte Erweiterungen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08554_