_CrtSetReportMode

  • Статья

Определяет цель или назначении для конкретного типа отчета, созданного 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. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

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