`_RTC_SetErrorType`

Article
10/26/2022

Associates an error that is detected by run-time error checks (RTCs) with a type. Your error handler processes how to output errors of the specified type.

Syntax

int _RTC_SetErrorType(
   _RTC_ErrorNumber errnum,
   int ErrType
);

Parameters

errnum
A number between zero and one less than the value returned by _RTC_NumErrors.

ErrType
A value to assign to this errnum. For example, you might use _CRT_ERROR. If you're using _CrtDbgReport as your error handler, ErrType can only be one of the symbols defined in _CrtSetReportMode. If you have your own error handler (_RTC_SetErrorFunc), you can have as many ErrType values as there are errnum values.

An ErrType of _RTC_ERRTYPE_IGNORE has special meaning to _CrtSetReportMode; the error is ignored.

Return value

The previous value for the error type replaced by ErrType.

Remarks

By default, all errors are set to ErrType = 1, which corresponds to _CRT_ERROR. For more information about the default error types such as _CRT_ERROR, see _CrtDbgReport.

Before you can call this function, you must first call one of the run-time error check initialization functions; see Using runtime checks without the C runtime library

Requirements

Routine	Required header
`_RTC_SetErrorType`	<rtcapi.h>

For more information, see Compatibility.

Libraries

All versions of the C run-time libraries.

Share via