Specifies the destination(s) for a specific report type generated by _CrtDbgReport and any macros that call _CrtDbgReport or _CrtDbgReportW, such as these macros (debug version only): _ASSERT, _ASSERTE, _RPT, and _RPTF.

int _CrtSetReportMode (
    int nRptType, 
    int fMode 
);

Parameters

nRptType

Report type: _CRT_WARN, _CRT_ERROR, and _CRT_ASSERT.

fMode

New report mode(s) for nRptType.

Remarks

_CrtSetReportMode specifies _CrtDbgReport's output destination. Because the macros _ASSERT, _ASSERTE, _RPT, and _RPTF call _CrtDbgReport, _CrtSetReportMode specifies the output destination of text specified with those macros.

When _DEBUG is not defined, preprocessing removes calls to _CrtSetReportMode.

If you do not call _CrtSetReportMode to define the output destination of messages, then the following defaults are in effect:

• Assertion failures and errors are directed to a console window.
• Warnings from Windows applications are sent to the console output window.

The following table lists the report types defined in Crtdbg.h.

_CrtSetReportMode assigns the new report mode specified in fMode to the report type specified in nRptType and returns the previously defined report mode for nRptType. The following table lists available choices for fMode and the resulting behavior of _CrtDbgReport. crtdbg.h defines these options as bit flags.

Each report type can be reported using one, two, or three modes, or no mode at all. Therefore, you can have more than one destination defined for a single report type. For example, the following code fragment sends assertion failures to both a debug message window and to stderr:

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

In addition, you can separately control the reporting mode(s) for each report type. For example, you can send an nRptType of _CRT_WARN to an output debug string while displaying _CRT_ASSERT using a debug message window and sending to stderr, as previously illustrated.

Return Values

On successful completion, _CrtSetReportMode returns the previous report mode(s)s for the report type specified in nRptType.

Requirements