This topic has not yet been rated - Rate this topic

_RTC_SetErrorFuncW

Visual Studio 2012

Designates a function as the handler for the reporting of run-time error checks (RTCs).

_RTC_error_fnW _RTC_SetErrorFuncW( 
   _RTC_error_fnW function  
);

Parameters

function: The address of the function that will handle run-time error checks.

Return Value

The previously defined error function; or NULL if there is no previously defined function.

Remarks

In new code, use only _RTC_SetErrorFuncW. _RTC_SetErrorFunc is only included in the library for backward compatibility.

The _RTC_SetErrorFuncW callback applies only to the component that it was linked in, but not globally.

Make sure that the address that you pass to _RTC_SetErrorFuncW is that of a valid error handling function.

If an error has been assigned a type of –1 by using _RTC_SetErrorType, the error handling function is not called.

Before you can call this function, you must first call one of the run-time error-check initialization functions. For more information, see Using Run-Time Checks Without the C Run-Time Library.

_RTC_error_fnW is defined as follows:

typedef int (__cdecl *_RTC_error_fnW)(int errorType , const wchar_t * filename , int linenumber , const wchar_t * moduleName , const wchar_t * format , ...);

where:

errorType: The type of error that's specified by _RTC_SetErrorType.
filename: The source file where the failure occurred, or null if no debug information is available.
linenumber: The line in filename where the failure occurred, or 0 if no debug information is available.
moduleName: The DLL or executable name where the failure occurred.
format: printf style string to display an error message, using the remaining parameters. The first argument of the VA_ARGLIST is the RTC Error number that occurred.

For an example that shows how to use _RTC_error_fnW, see Native Run-Time Checks Customization.

Requirements

Routine	Required header
_RTC_SetErrorFuncW	<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.

Tasks

RTC Sample: Run-Time Error Checks

Reference

_CrtDbgReport, _CrtDbgReportW

Run-Time Error Checking

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)