_CrtSetReportMode
_CrtSetReportMode
指定的目标或目标的生成的特定报表类型 _CrtDbgReport和调用任何宏_CrtDbgReport、 _CrtDbgReportW，如_ASSERT、 _ASSERTE、_ASSERT_EXPR 宏， _ASSERT、 _ASSERTE、 _ASSERT_EXPR 宏， _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 | 创建一个消息框显示消息以及中止，重试，并忽略按钮。 |
| _CRTDBG_REPORT_MODE | 返回reportMode指定reportType: 1 _CRTDBG_MODE_FILE 2 _CRTDBG_MODE_DEBUG 4 _CRTDBG_MODE_WNDW |
可以使用一种、两种或三种模式，或不使用任何模式报告每种报告类型。 因此，可以为单个报告类型定义多个目标。 例如，下面的代码段导致将断言失败发送到这两个调试消息窗口和stderr:
_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );
此外，可以分别控制报告模式和每个报告类型的模式。 例如，它是可以指定reportType的 _CRT_WARN会发送到输出调试字符串，而 _CRT_ASSERT是使用调试消息窗口显示并发送到stderr，如前面所示。
要求
| 例程所返回的值 | 必需的标头 | 可选标头 |
|---|---|---|
| _CrtSetReportMode | <crtdbg.h> | <errno.h> |
