_CrtSetReportHook
Instaluje funkcji sprawozdawczości określone przez klienta przez podczepiania go do debugowania run-time C, zgłoszenie procesu (tylko wersja debugowania).
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parametry
- reportHook
Nowy klient raportowania funkcji hook do c run-time, debugowanie procesu generowania raportów.
Wartość zwracana
Zwraca poprzedniego klienta zdefiniowanych funkcji raportowania.
Uwagi
_CrtSetReportHookumożliwia aplikacji przy użyciu własnych raportowania funkcji w c biblioteki run-time debugowania procesu sprawozdawczości.W rezultacie, w każdym przypadku, gdy _CrtDbgReport nazywa się wygenerować raport debugowania, stosowania przez raportowania, najpierw wywoływana jest funkcja.Ta funkcja umożliwia aplikacji do wykonywania operacji, takich jak filtrowanie raportów debugowania tak może skupić się na typy szczególny przydział lub wysłać raport do miejsc docelowych, nie są dostępne przy użyciu _CrtDbgReport.Gdy _DEBUG nie jest zdefiniowana, wzywa do _CrtSetReportHook są usuwane w czasie wstępnego przetwarzania.
Bardziej niezawodny wersji _CrtSetReportHook, zobacz _CrtSetReportHook2.
_CrtSetReportHook Funkcja instaluje nowego klienta zdefiniowane sprawozdawczości określone w funkcji reportHook i zwraca poprzedniego hook zdefiniowane przez klienta.Poniższy przykład ilustruje, jak powinny być zdefiniowała hook sprawozdania określone przez klienta:
int YourReportHook( int reportType, char *message, int *returnValue );
gdy reportType jest typ raportu debugowania (_CRT_WARN, _CRT_ERROR, lub _CRT_ASSERT), message jest wiadomość użytkownika zmontowanych debugowania mają być zawarte w sprawozdaniu, i returnValue jest na wartość określoną przez zdefiniowane klienta Raportowanie funkcji, który powinien być zwrócony przez _CrtDbgReport.Aby uzyskać pełny opis typy dostępnych raportów, zobacz _CrtSetReportMode funkcji.
Jeśli funkcja raportowania zdefiniowana przez klienta obsługuje całkowicie komunikat debugowania, takie, że nie dalsze zgłoszenie jest wymagane, funkcja powinna zwrócić TRUE.Kiedy funkcja zwraca FALSE, _CrtDbgReport jest wywoływana w celu wygenerowania raportu debugowania przy użyciu bieżących ustawień typ raportu, tryb i pliku.Ponadto, określając _CrtDbgReport , zwracają wartość w returnValue, aplikacji można również kontrolować, czy występuje podział debugowania.Pełny opis jak skonfigurowane i wygenerowany raport debugowania, zobacz _CrtSetReportMode, _CrtSetReportFile, i _CrtDbgReport.
Aby uzyskać więcej informacji dotyczących używania innych funkcji, zdolne do haka run-time i pisania własnych klienta zdefiniowane hook funkcji, zobacz Piśmie swój własny debugowania hak funkcje.
[!UWAGA]
Jeśli aplikacja została skompilowana z /clr i raportowania funkcja jest wywoływana po aplikacji został zakończony główne, środowisko CLR wygeneruje wyjątek funkcja raportowania wywołuje żadnych funkcji CRT.
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.
Biblioteki
Debug wersje biblioteki uruchomieniowej c tylko.
Przykład
Przykładowy sposób _CrtSetReportHook, zobacz sprawozdania.
Odpowiednik w programie .NET Framework
Nie dotyczy. Aby wywołać standardowych funkcji C, należy użyć PInvoke. Aby uzyskać więcej informacji, zobacz Przykłady wywołać platformy.