_RTC_SetErrorFuncW

指定函式做為報告執行階段錯誤檢查 (RTC) 的處理常式。

語法

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

參數

function
函式的位址，會處理執行階段錯誤檢查。

傳回值

先前定義的錯誤函式;如果沒有 NULL 先前定義的函式，則為 。

備註

在新程式碼中，請一律使用 _RTC_SetErrorFuncW。 程式庫中只包含_RTC_SetErrorFunc 供回溯相容性之用。

_RTC_SetErrorFuncW 回呼僅適用其所連結的元件，而非適用於全域。

請確定您傳遞給 _RTC_SetErrorFuncW 的位址是有效錯誤處理函式的位址。

如果使用 指派了 -1 _RTC_SetErrorType 類型的錯誤，則不會呼叫錯誤處理函式。

您必須先呼叫任一個執行階段錯誤檢查初始化函式，才能呼叫此函式。 如需詳細資訊，請參閱 不使用 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 執行階段程式庫。

另請參閱

_CrtDbgReport, _CrtDbgReportW
執行時間錯誤檢查