_RTC_SetErrorType

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.

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 are 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 ErrTypes as there are errnums.

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

Return Value

The previous value for the error type type.

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 Run-Time Checks without the C Run-Time Library

Requirements

Routine

Required header

_RTC_SetErrorType

<rtcapi.h>

For more information, see Compatibility.

Libraries

All versions of the C run-time libraries.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

See Also

Tasks

RTC Sample: Run-Time Error Checks

Reference

_RTC_GetErrDesc

Run-Time Error Checking