_RTC_SetErrorType

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _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.

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 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

_RTC_GetErrDesc
Run-Time Error Checking