_CrtSetReportMode

Статья
02/20/2013

Определяет цель или назначении для конкретного типа отчета, созданного by _CrtDbgReport и все макросы, вызывающие _CrtDbgReport, _CrtDbgReportWкак _ASSERT _ASSERTE - макрос" _ASSERT _ASSERTE - макрос" _RPT, _RPTF, _RPTW, макросы _RPTFWи _RPT, _RPTF, _RPTW, макросы _RPTFW (отладка версия).

int _CrtSetReportMode( 
   int reportType,
   int reportMode 
);

Параметры

reportType
Тип отчета: _CRT_WARN" _CRT_ERRORи _CRT_ASSERT.
reportMode
Новые режим или режим отчета reportType.

Возвращаемое значение

При успешном завершении _CrtSetReportMode возвращает предыдущий режим или режим отчета для типа, определенного внутри отчета reportType.Если недопустимое значение передается в качестве reportType указан или является недопустимым, режим reportMode" _CrtSetReportMode недопустимый параметр вызывает обработчик как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то наборы этой функции errno В EINVAL и возвращает -1.Дополнительные сведения см. в разделе errno, _doserrno, _sys_errlist и _sys_nerr.

Заметки

_CrtSetReportMode определяет назначение выходных данных для _CrtDbgReport.Поскольку макросы _ASSERT" _ASSERTE" _RPTи _RPTF вызов _CrtDbgReport" _CrtSetReportMode определяет назначение вывода текста, заданную с этими макросами.

После _DEBUG не указывает, вызовы _CrtSetReportMode удалите во время предварительной обработки.

Если не вызвать _CrtSetReportMode чтобы указать назначение вывода сообщений, затем следующие значения по умолчанию в результате:

Сбои утверждения и ошибки, направляются в окно сообщения отладки.
Предупреждения из windows-приложения отправляются в окне вывода отладчика.
Предупреждения из консольных приложений не отображаются.

В следующей таблице перечислены типы отчета, определенные в Crtdbg.h.

Тип отчета	Описание
_CRT_WARN	Предупреждения, сообщения и сведения, которые не требуется немедленное внимание.
_CRT_ERROR	Неустранимая ошибка, проблем и проблемы, которые требуют немедленных внимания.
_CRT_ASSERT	Сбои утверждения (утверженные выражения, оцените к FALSE).

_CrtSetReportMode функция присвоит новый режим, заданный в пределах отчета reportMode к типу, указанному в пределах отчета reportType и возвращает предварительно определенный режим отчета reportType.В следующей таблице перечислены доступные варианты reportMode и результирующая функциональности _CrtDbgReport.Эти параметры указываются как битов пометит в Crtdbg.h.

Режим отчета	Реакция на событие _CrtDbgReport
_CRTDBG_MODE_DEBUG	Записывает сообщение в окно вывода отладчика.
_CRTDBG_MODE_FILE	Записывает сообщение в пользователь-поставленному дескриптор файла._CrtSetReportFile должен быть вызван для указания файла или потока, характерный для использования в качестве назначения.
_CRTDBG_MODE_WNDW	Создает окно сообщения для отображения сообщения вместе с Abort" Retryи Ignore кнопки.
_CRTDBG_REPORT_MODE	Возвращает reportMode для указанного reportType. 1 _CRTDBG_MODE_FILE 2 _CRTDBG_MODE_DEBUG 4 _CRTDBG_MODE_WNDW

Каждый тип отчета можно сообщить с помощью одного, 2 или 3 режим или режим.Следовательно, можно иметь несколько цель, определенную для одного типа отчета.Например, в следующем фрагменте кода приводит к возникновению ошибки утверждения отправкой и в окне сообщения отладки и к stderr.

_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );

Кроме того, режим отчетов или режимы для каждого типа отчета можно отдельно.Например, можно указать, что значение a reportType**_CRT_WARN** отправить на выход строки, во время отладки _CRT_ASSERT отображение с помощью окна сообщения отладки и отправить stderrкак показано выше.

Требования

Процедура	Обязательный заголовок	Необязательный заголовок
_CrtSetReportMode	<crtdbg.h>	<errno.h>

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

библиотеки: Отладочные версии Функции библиотеки CRT только для чтения.

Пример

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

Эквивалент в .NET Framework

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

См. также

Ссылки

Подпрограммы отладка

Поделиться через