_RTC_SetErrorFuncW
関数をランタイム エラー チェック (RTC) のレポート用ハンドラーとして指定します。
_RTC_error_fnW _RTC_SetErrorFuncW(
_RTC_error_fnW function
);
パラメーター
- 機能性
ランタイム エラー チェックを処理する関数のアドレス。
戻り値
以前に定義されているエラー関数。 以前に定義されている関数がない場合は、NULL を返します。
解説
新しいコードでは、_RTC_SetErrorFuncW のみを使用します。 _RTC_SetErrorFunc は、下位互換性のためにのみライブラリに含まれています。
_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: Dynamic-Link Library) 名または実行可能ファイル名。形式
残りのパラメーターを使用してエラー メッセージを表示する文字列。printf 関数の文字列と似ています。 VA_ARGLIST の最初の引数は、発生した RTC エラー番号です。
_RTC_error_fnW の使用例については、「Customizing CRT Run-Time Error Checking」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_RTC_SetErrorFuncW |
<rtcapi.h> |
詳細については、「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。