_RTC_SetErrorFuncW

将函数指定为报告运行时错误检查 (RTC) 的处理程序。

语法

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

参数

function
处理运行时错误检查的函数的地址。

返回值

以前定义的错误函数;或者如果不存在以前定义的任何函数,则为 NULL

备注

在新代码中,仅使用 _RTC_SetErrorFuncW_RTC_SetErrorFunc 仅包含在适用于后向兼容性的库中。

_RTC_SetErrorFuncW 回调仅适用于它链接的组件,但不是全局适用。

确保传递给 _RTC_SetErrorFuncW 的地址是有效的错误处理函数的地址。

如果使用 _RTC_SetErrorType 为错误分配了类型 -1,则不会调用错误处理函数。

在可以调用此函数之前,首先必须调用其中一个运行时错误检查初始化函数。 有关详细信息,请参阅在没有 C 运行时库的情况下使用运行时检查

_RTC_error_fnW 定义如下:

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

其中:

errorType
_RTC_SetErrorType 指定的错误类型。

filename
为发生故障的源文件,或者,如果没有调试信息,则为 null。

linenumber
发生故障的 filename 中的行,或者如果没有调试信息可用,则为 0。

moduleName
DLL 或发生故障的可执行文件的名称。

format
要使用剩余的参数显示错误消息的 printf 样式字符串。 VA_ARGLIST 的第一个参数是出现的 RTC 错误号。

有关演示如何使用 _RTC_error_fnW 的示例,请参阅本机运行时检查自定义

要求

例程 必需的标头
_RTC_SetErrorFuncW <rtcapi.h>

有关详细信息,请参阅兼容性

C 运行时库的所有版本。

另请参阅

%>
运行时错误检查