_CrtSetReportFile
_CrtSetReportModeの _CRTDBG_MODE_FILEを指定すると、メッセージ テキストを受け取るために、ファイル ハンドルを指定できます。_CrtDbgReport、_CrtDbgReportW によって、_CrtSetReportFile がテキスト (デバッグ バージョンだけ) の出力先を指定するために使用されます。
_HFILE _CrtSetReportFile(
int reportType,
_HFILE reportFile
);
パラメーター
reportType
:レポートの種類 _CRT_WARN、_CRT_ERRORと _CRT_ASSERT。reportFile
reportTypeの新しいレポート ファイル。
戻り値
正常に終了した場合、_CrtSetReportFile は reportTypeで指定されたレポートの種類に対して定義される前のレポート ファイルを返します。無効な値が reportTypeとしてを渡すと、この関数は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーが実行されます。実行の継続が許可された場合、errno が EINVAL に設定され、関数から _CRTDBG_HFILE_ERROR が返されます。詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
解説
_CrtSetReportMode 関数と**_CrtSetReportFile** が _CrtDbgReportによって生成される特定のレポートの種類の移動先を定義するために使用されます。特定のレポートの種類の _CRTDBG_MODE_FILE のレポート モードを再配置するには _CrtSetReportMode が呼び出された特定のファイルを定義するか、コピー先として使用するデータ フローが実現 _CrtSetReportFile、を呼び出す必要があります。_DEBUG が未定義の場合、_CrtSetReportFile の呼び出しはプリプロセスで削除されます。
次の表は reportFile で使用できるオプションの一覧と _CrtDbgReportの結果の動作を示しています。これらのオプションは、Crtdbg.h が bit でフラグが設定として定義されます。
file handle
メッセージの対象となるファイルのハンドル。まず、ハンドルの有効性を検証されません。ファイルへのハンドルを開閉する必要があります。次に例を示します。HANDLE hLogFile; hLogFile = CreateFile("c:\\log.txt", GENERIC_WRITE, FILE_SHARE_WRITE, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE); _CrtSetReportFile(_CRT_WARN, hLogFile); _RPT0(_CRT_WARN,"file message\n"); CloseHandle(hLogFile);
_CRTDBG_FILE_STDERR
次のようにリダイレクトできる stderrにメッセージを書き込みます場合:freopen( "c:\\log2.txt", "w", stderr); _CrtSetReportMode(_CRT_ERROR, _CRTDBG_MODE_FILE); _CrtSetReportFile(_CRT_ERROR, _CRTDBG_FILE_STDERR); _RPT0(_CRT_ERROR,"1st message\n");
_CRTDBG_FILE_STDOUT
ユーザーがリダイレクトできる stdoutにメッセージを書き込みます。_CRTDBG_REPORT_FILE
現在のレポート モードを返します。
各レポートの種類により使用されるレポート ファイルを個別に制御できます。たとえば _CRT_ASSERT の reportType は、ユーザー定義のファイル ハンドルやストリームに報告されますが、_CRT_ERROR の reportType が stderrに通知されるように指定することがあります。
必要条件
ルーチン |
必須ヘッダー |
オプション ヘッダー |
---|---|---|
_CrtSetReportFile |
<crtdbg.h> |
<errno.h> |
コンソールは Windows ストア の apps ではサポートされていません。コンソール、stdin、stdout、および stderrに関連付けられている標準ストリームのハンドルは C のランタイム関数が Windows ストア の apps で使用する前にをリダイレクトする必要があります。互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ:CRT ライブラリの機能 のデバッグ バージョンのみ。
使用例
「report」を参照してください。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。