通过

_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 运行时库的所有版本。

另请参阅

%>
运行时错误检查