_CrtSetReportHook
Nainstaluje funkci definováno klientských sestav tak, že zapojení do procesu vykazování spuštění ladění C (pouze ladicí verze).
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parametry
- reportHook
Nový klient definované přídavné funkce připojí do C run-time ladit výkaznictvím.
Vrácená hodnota
Vrátí předchozí klient definované funkce vytváření sestav.
Poznámky
_CrtSetReportHookumožňuje aplikacím použít vlastní funkci vytváření sestav do knihovny C run-time ladění procesu vykazování.Proto, kdykoli _CrtDbgReport se nazývá ke generování sestavy ladění, je vykazování aplikace nejprve je volána funkce.Tato funkce umožňuje provádět operace, například filtrování zprávy ladění, takže se můžete zaměřit na konkrétní rozdělení typů nebo odeslat sestavu cíle není k dispozici pomocí aplikace _CrtDbgReport.Při _DEBUG není definován, je volání do _CrtSetReportHook jsou odstraněny během předběžného zpracování.
Výkonnější verze _CrtSetReportHook, viz _CrtSetReportHook2.
_CrtSetReportHook Funkce nainstaluje nový klient definován hlášení funkce uvedené v reportHook a vrátí předchozí definice klienta háku.Následující příklad ukazuje, jak by mělo být definováno klientských sestav háčkem prototypem:
int YourReportHook( int reportType, char *message, int *returnValue );
kde reportType je typ zprávy ladění (_CRT_WARN, _CRT_ERROR, nebo _CRT_ASSERT), message je plně sestavený ladění zprávu mají být obsaženy v sestavě, a returnValue hodnotu určenou definováno klientských sestav funkce, která by měla být vrácena podle _CrtDbgReport.Úplný popis typů dostupných sestav naleznete v tématu _CrtSetReportMode funkce.
Pokud klient definován přídavné funkce zcela zpracovává zprávy ladění tak, aby další vykazování se nevyžaduje, pak měli vrátit funkce TRUE.Při vrátí funkce FALSE, _CrtDbgReport se nazývá ke generování sestavy ladění pomocí aktuálního nastavení pro typ sestavy, režimu a soubor.Kromě toho určením _CrtDbgReport vrátí hodnotu v returnValue, aplikace můžete také určit, zda dojde k přerušení ladění.Úplný popis jak sestavy ladění a je generována v _CrtSetReportMode, _CrtSetReportFile, a _CrtDbgReport.
Další informace o použití jiných schopný háček běhové funkce a psaní vlastní klient definované funkce připojit, naleznete v tématu Zápis funkce háku ladění.
[!POZNÁMKA]
Pokud je aplikace kompilována s /clr a přídavné funkce je volána po aplikaci, která opustila hlavní, CLR vyvolat výjimku, pokud zpravodajské funkce volá všechny funkce CRT.
Požadavky
Rutina |
Požadované záhlaví |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Další informace o kompatibilitě naleznete v úvodu tématu Kompatibilita.
Knihovny
Verze ladění pouze běhových knihoven C.
Ekvivalent v rozhraní .NET Framework
Nelze použít. Pokud chcete volat standardní funkci jazyka C, použijte PInvoke. Další informace naleznete v tématu Příklady vyvolání platformy.