_CrtSetReportHook
Задает клиент-определенная функции отчетности путем ее выполнение среды выполнения c отчетов процесс отладки (отладочные версии).
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Параметры
- reportHook
Новая функция клиент-определенная отчетов на обработчик среды выполнения c процесс отладки отчетов.
Возвращаемое значение
Возвращает предыдущую клиент-определенную функции отчетности.
Заметки
_CrtSetReportHook позволяет приложению использовать собственную функцию отчетности среды выполнения c процесс отладки отчетов библиотеки.в результате, когда _CrtDbgReport вызывается для создания отчетов, функция отчетов об отладке приложения вызывает первым.Эта функциональность позволяет приложению выполнять операции отладки, как фильтровать отчеты поэтому она может отобрать выделения или отправить отчет на назначения не доступным с помощью _CrtDbgReport.После _Отладка не указывает, вызовы _CrtSetReportHook удалите во время предварительной обработки.
Для более робастной версии _CrtSetReportHookсм. _CrtSetReportHook2.
_CrtSetReportHook функция задает новую клиент-определенная функция, определенная в пределах отчета reportHook и возвращает предыдущий клиент-определенный обработчик.В следующем примере показано, как клиент-определенный обработчик отчетов должен быть prototyped:
int YourReportHook( int reportType, char *message, int *returnValue );
где reportType тип отладки (отчета_CRT_WARN" _CRT_ERRORили _CRT_ASSERT) message сообщение полностью, собранные с помощью отладки пользователя, который должен содержаться в отчете, а также returnValue значение, указанное клиент-определенной функцией отчетов, которая должна быть возвращена by _CrtDbgReport.Полное описание доступных типов отчета см. в разделе _CrtSetReportMode функция.
Если функция отчетов клиент-определенная полностью обрабатывает сообщение отладки таковы, что нет необходимости более добавочная отчетов, то функция должна возвращать TRUE.Когда функция возвращает FALSE" _CrtDbgReport вызывается для создания отчетов об отладке с использованием текущих параметров для типа отчета, режимом и файлов.Кроме того, при указании _CrtDbgReport возвращаемое значение в пределах returnValueприложение может также отслеживать, происходит ли разрыв отладки.Полное описание, как настроен и создается отчет об отладке см. _CrtSetReportMode" _CrtSetReportFileи _CrtDbgReport.
Дополнительные сведения об использовании других обработчик-способных функций среды выполнения и создавать собственные клиент-определенные функции обработчика см. в разделе Создание собственных функций обработчика отладки.
.gif "Примечание") Примечание |
|---|
Если приложение компилироваться с /clr и функция отчетов вызывается после того как приложение остается качестве основы, среда CLR вызывает исключение, если вызовы функции отчетов любой функции CRT. |
Требования
Процедура |
Обязательный заголовок |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Дополнительные сведения о совместимости см. Совместимость во введении.
Библиотеки
Отладочные версии Библиотеки времени выполнения C только для чтения.
Пример
Пример использования _CrtSetReportHookсм. отчет.
Эквивалент в .NET Framework
Неприменимо. Для c# используйте стандартная функция PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.