_CrtSetReportHook
Installiert eine clientdefinierte Berichtsfunktion, indem sie mit dem Debug-Berichterstellungsprozess der C-Laufzeit verknüpft wird (nur Debugversion).
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parameter
- reportHook
Die neue clientdefinierte Berichtsfunktion, die mit dem Debug-Berichterstellungsprozess der C-Laufzeit verknüpft werden soll.
Rückgabewert
Gibt die vorherige clientdefinierte Berichtsfunktion zurück.
Hinweise
_CrtSetReportHook ermöglicht es einer Anwendung, eine eigene Berichtsfunktion im Debugbibliothek-Berichterstellungsprozess der C-Laufzeit zu verwenden. Folglich wird bei jedem Aufruf von _CrtDbgReport zum Generieren eines Debugberichts die Berichtsfunktion der Anwendung zuerst aufgerufen. Diese Funktionalität ermöglicht es einer Anwendung, Vorgänge wie das Filtern von Debugberichten auszuführen, sodass sie sich auf bestimmte Zuordnungstypen konzentrieren oder einen Bericht an nicht verfügbare Ziele senden kann, indem _CrtDbgReport verwendet wird. Wenn _DEBUG nicht definiert ist, werden Aufrufe von _CrtSetReportHook während der Vorverarbeitung entfernt.
Eine robustere Version von _CrtSetReportHook finden Sie unter _CrtSetReportHook2.
Die _CrtSetReportHook-Funktion installiert die neue clientdefinierte Berichtsfunktion, die in reportHook angegeben wird, und gibt die vorherige clientdefinierte Hookfunktion zurück. Das folgende Beispiel zeigt, wie ein Prototyp einer clientdefinierten Hookfunktion für Berichte entwickelt werden soll:
int YourReportHook( int reportType, char *message, int *returnValue );
wobei Folgendes gilt: reportType ist der Debugberichtstyp (_CRT_WARN, _CRT_ERROR oder _CRT_ASSERT), message ist die vollständig assemblierte Debugbenutzermeldung, die im Bericht enthalten sein sollte, und returnValue ist der von der clientdefinierten Berichtsfunktion angegebene Wert, der von _CrtDbgReport zurückgegeben werden soll. Eine vollständige Beschreibung der verfügbaren Berichtstypen finden Sie in der _CrtSetReportMode-Funktion.
Wenn die clientdefinierte Berichtsfunktion die Debugmeldung vollständig bearbeitet, sodass kein weiterer Bericht erforderlich ist, sollte die Funktion TRUE zurückgeben. Wenn die Funktion FALSE zurückgibt, wird _CrtDbgReport aufgerufen, um den Debugbericht mithilfe der aktuellen Einstellungen für den Berichtstyp, den Berichtsmodus und die Berichtsdatei zu generieren. Wenn darüber hinaus der _CrtDbgReport-Rückgabewert in returnValue angegeben wird, kann die Anwendung auch steuern, ob ein Debugabbruch auftritt. Eine vollständige Beschreibung der Konfiguration und Generierung des Debugberichts finden Sie unter _CrtSetReportMode, _CrtSetReportFile und _CrtDbgReport.
Weitere Informationen zur Verwendung anderer hookfähiger Laufzeitfunktionen und zum Schreiben eigener clientdefinierter Hookfunktionen finden Sie unter Schreiben von Hookfunktionen zum Debuggen.
Hinweis
Wenn die Anwendung mit /clr kompiliert und die Berichtsfunktion nach dem Beenden der Anwendung "Main" aufgerufen wird, löst die CLR eine Ausnahme aus, wenn die Berichterstellungsfunktion eine CRT-Funktion aufruft.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Nur Debugversionen von C-Laufzeitbibliotheken.
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.