_CrtSetReportHook
Nainstaluje klienta definované přídavné funkce tak zapojení do c spuštění ladění procesu (pouze ladicí verze) vykazování.
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parametry
- reportHook
Nové přídavné funkce definované klienta k zapojení do C Runtime ladění procesu vykazování.
Vrácená hodnota
Vrátí předchozí klienta definované funkce vykazování.
Poznámky
_CrtSetReportHookumožňuje aplikaci použít vlastní funkci vykazování do c knihovnu spuštění ladění procesu vykazování.Výsledkem je, kdykoli _CrtDbgReport se nazývá Chcete-li generovat sestavy ladění aplikace pro vykazování první volání funkce.Tato funkce umožňuje provádět operace, například filtrování sestav ladění proto soustředí na přidělení určité typy nebo odeslat zprávu na cíle není k dispozici pomocí aplikace _CrtDbgReport.Při _DEBUG není definována, volání do _CrtSetReportHook jsou odebrány při úpravě před zpracováním.
Výkonnější verzi pro _CrtSetReportHook, viz _CrtSetReportHook2.
_CrtSetReportHook Funkce nainstaluje nový klient definován hlášení funkce v reportHook a vrátí předchozí háčkem definované klienta.Následující příklad ukazuje, jak mají být prototyped háčku klienta definované sestavy:
int YourReportHook( int reportType, char *message, int *returnValue );
kde reportType je typ sestavy ladění (_CRT_WARN, _CRT_ERROR, nebo _CRT_ASSERT), message je plně sestavený ladění zprávu být obsaženy v sestavě, a returnValue hlásí hodnotu určenou klienta definované funkce, které mají být vráceny _CrtDbgReport.Úplný popis typů dostupných sestav najdete _CrtSetReportMode funkce.
Pokud klient definované přídavné funkce zcela zpracovává zprávy ladění, další vykazování se nevyžaduje, pak funkce měla vracet TRUE.Když vrátí funkce FALSE, _CrtDbgReport se nazývá generovat sestavy ladění pomocí aktuálního nastavení pro typ sestavy, režim a souboru.Kromě toho zadáním _CrtDbgReport vrácená hodnota v returnValue, aplikace můžete také určit, zda dojde k přerušení ladění.Úplný popis jak sestavy ladění a je vygenerována, viz _CrtSetReportMode, _CrtSetReportFile, a _CrtDbgReport.
Další informace o použití jiných funkcí háčkem schopen běhu a psaní vlastního klienta definované zavěšení funkce, viz Psaní svůj vlastní ladění háčkem funkce.
[!POZNÁMKA]
Pokud aplikace je kompilována s /clr a přídavné funkce se nazývá po aplikaci byl ukončen hlavní, CLR vyvolají výjimku, pokud zpravodajské funkce volá všechny funkce CRT.
Požadavky
Rutina |
Požadované záhlaví |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Další informace o kompatibilitě v tématu Compatibility v úvodu.
Knihovny
Ladění verze C Runtime knihovny pouze.
Příklad
Ukázku použití _CrtSetReportHook, viz Sestava.
Ekvivalent v rozhraní .NET Framework
Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.