Экспорт (0) Печать
Развернуть все
and
div
eof
not
or
xor
Развернуть Свернуть
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

_CrtSetReportHook

Устанавливает определяемую клиентом функцию отчетов путём её прикрепления в процесс создания отчетов среды выполнения языка C (только отладочная версия).

_CRT_REPORT_HOOK _CrtSetReportHook( 
   _CRT_REPORT_HOOK reportHook 
);

reportHook

Новая определяемая клиентом функция отчетов, которую необходимо прикрепить в процесс создания отчетов среды выполнения языка C.

Возвращает предыдущую определяемую клиентом функцию отчетов.

_CrtSetReportHook позволяет приложению использовать собственную сообщающую об ошибках функцию в процессе обработки ошибок отладочной библиотеки времени выполнения языка C. В результате, всякий раз, когда вызывается _CrtDbgReport для создания отчета отладки, сначала вызывается функция отчетов приложения. Эта функциональность позволяет приложению выполнять такие операции, как фильтрация отчетов отладки, чтобы отобрать выделения конкретного типа или отправить отчет в назначения, которые недоступны при использовании _CrtDbgReport. Если _DEBUG не определен, то вызовы _CrtSetReportHook удаляются во время предварительной обработки.

Более надежную версию _CrtSetReportHook см. в разделе _CrtSetReportHook2.

Функция _CrtSetReportHook устанавливает определяемую клиентом функцию отчетов, указанную в reportHook и возвращает предыдущую определенную клиентом функцию. В следующем примере показано, как должна быть объявлена определяемая клиентом функция отчетов:

int YourReportHook( int reportType, char *message, int *returnValue );

где reportType - тип отчета отладки (_CRT_WARN, _CRT_ERROR или _CRT_ASSERT), message - полностью собранное пользовательское отладочное сообщение, которое будет содержаться в отчете, а returnValue - значение, указанное определяемой клиентом функцией отчетов, которое должна быть возвращено _CrtDbgReport. Полное описание доступных типов отчетов см. в разделе _CrtSetReportMode.

Если определяемая клиентом функция отчетов полностью обрабатывает сообщение отладки так, что дальнейшая выдача отчета не требуется, то функция должна возвращать TRUE. Если функция возвращает FALSE, _CrtDbgReport вызывается для создания отчета отладки с использованием текущих параметров для типа, режима и файла отчета. Кроме того, указав возвращаемое значение _CrtDbgReport в returnValue, приложение может контролировать, происходит ли прерывание при отладке. Полное описание настройки и создания отчета об отладке см. в разделах _CrtSetReportMode, _CrtSetReportFile и _CrtDbgReport.

Дополнительные сведения о других способных на обработку функциях среды выполнения и написании собственных определяемых клиентом функциях-ловушках см. в разделе Написание функций отладочных ловушек.

ПримечаниеПримечание

Если приложение компилировано с /clr и функциональность отчетов вызывается после того, как приложение покидает main, среда CLR вызывает исключение, если функции отчета вызывают какие-либо функции CRT.

Подпрограмма

Требуемый заголовок

_CrtSetReportHook

<crtdbg.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Библиотеки

Только отладочные версии Библиотеки времени выполнения языка C.

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

Добавления сообщества

ДОБАВИТЬ
Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft