_CrtDbgReport, _CrtDbgReportW

아티클
02/21/2013

보고서 디버깅 메시지를 생성 하 고 세 가지 가능한 대상 (디버그 버전에만 해당) 보고서를 보냅니다.

int _CrtDbgReport( 
   int reportType,
   const char *filename,
   int linenumber,
   const char *moduleName,
   const char *format [,
   argument] ... 
);
int _CrtDbgReportW( 
   int reportType,
   const wchar_t *filename,
   int linenumber,
   const wchar_t *moduleName,
   const wchar_t *format [,
   argument] ... 
);

매개 변수

reportType
Report type: _CRT_WARN, _CRT_ERROR, and _CRT_ASSERT.
filename
가정/보고서 발생 하는 소스 파일의 이름에 대 한 포인터 또는 NULL.
linenumber
가정/보고서를 발생 하는 소스 파일에서 여러 줄 또는 NULL.
moduleName
가정/보고서를 발생 모듈 (.exe 또는.dll)의 이름 포인터입니다.
format
사용자가 메시지를 작성 하는 데 사용 하는 컨트롤 서식 문자열을 포인터입니다.
argument
대체 옵션 인수를 사용 하는 format.

반환 값

모든 보고서 대상에 대 한 _CrtDbgReport 및 _CrtDbgReportW 오류가 발생 하는 경우 오류가 발생 하면 – 1과 0을 반환 합니다.그러나 보고서 대상 디버그 메시지 창 및 사용자가 되 면을 클릭의 Retry 단추를 이러한 함수 1을 반환 합니다.사용자가 클릭 하는 경우는 Abort 단추 메시지 디버그 창에서이 함수 즉시 중단 하 고 값을 반환 하지 않습니다.

_RPT, _RPTF 매크로 호출을 디버깅 _CrtDbgReport 의 디버그를 생성할 보고서입니다.이러한 매크로의 와이드 문자 버전을 같은 _ASSERT 스, _RPTWn 및 _RPTFWn, 사용 _CrtDbgReportW 의 디버그를 생성할 보고서입니다.때 _CrtDbgReport 또는 _CrtDbgReportW 1, 반환에서 just-in-time (JIT) 디버깅을 사용 하도록 설정 하는 경우에이 매크로 디버거를 시작 합니다.

설명

_CrtDbgReport및 _CrtDbgReportW 디버그 보고서를 세 가지 서로 다른 대상에 보낼 수 있습니다: 디버그 보고서 파일을 디버그 모니터 (는 Visual Studio 디버거에서), 또는 디버그 메시지 창입니다.두 가지 구성 기능 _CrtSetReportMode 및 _CrtSetReportFile, 대상 또는 각 보고서 유형에 대 한 대상을 지정 하는 데 사용 됩니다.이러한 함수는 보고 대상 또는 대상 보고서 형식별로 별도로 제어할 수 있습니다.예를 들어, 되도록 지정할 수 있습니다는 reportType 의 _CRT_WARN 만 수 디버그 모니터를 전송 하는 동안에 reportType 의 _CRT_ASSERT 디버그 메시지 창 및 사용자 지정 보고서 파일에 보낼 수.

_CrtDbgReportW와이드 문자 버전입니다 _CrtDbgReport.모든 출력 및 문자열 매개 변수에서 와이드 문자 문자열입니다. 그렇지 않으면이 싱글바이트 문자 버전으로 동일합니다.

_CrtDbgReport및 _CrtDbgReportW 대체 하 여 사용자 메시지 디버그 보고서를 만들는 argumentn에 인수는format 정의 된 동일한 규칙을 사용 하 여 문자열을 printf 또는 wprintf 함수.이러한 함수는 다음 디버그 보고서를 생성 하 고 대상 또는 대상에 따라 현재 보고서 모드에서 확인 및 정의 파일에 대 한 reportType.디버그 메시지 창에는 보고서를 보낼 때의 filename, lineNumber, 및 moduleName 창에 표시 되는 정보에 포함 되어 있습니다.

다음 표에서 사용할 수 있는 항목 보고서 모드 또는 모드, 파일 및 결과 동작의 _CrtDbgReport 및 _CrtDbgReportW.이러한 옵션은 비트 플래그로 crtdbg.h에 정의 됩니다.

보고서 모드	보고서 파일	_CrtDbgReport_CrtDbgReportW 동작
_CRTDBG_MODE_DEBUG	해당 없음	Windows 쓰기 메시지 내부적 API입니다.
_CRTDBG_MODE_WNDW	해당 없음	Windows를 호출 MessageBox API와 함께 메시지를 표시 하는 메시지 상자를 만들려면 Abort, Retry, 및 Ignore 단추.사용자가 클릭 하는 경우 Abort, _CrtDbgReport 또는 _CrtDbgReport 즉시 중단 됩니다.사용자가 클릭 하는 경우 Retry, 1을 반환 합니다.클릭할 경우 Ignore, 계속 실행 및 _CrtDbgReport 및 _CrtDbgReportW 0을 반환 합니다.참고 Ignore 때 "정의 되지 않은 동작이" 가끔 있는 오류 조건
_CRTDBG_MODE_FILE	__HFILE	쓰기 메시지에 사용자가 제공한 HANDLE, Windows를 사용 하 여 WriteFile API 파일 핸들;의 유효성을 확인 하지 않습니다 응용 프로그램 보고서 파일을 열고 잘못 된 파일 핸들을 전달에 대 한 책임이 있습니다.
_CRTDBG_MODE_FILE	_CRTDBG_FILE_STDERR	쓰기 메시지를 stderr.
_CRTDBG_MODE_FILE	_CRTDBG_FILE_STDOUT	쓰기 메시지를 stdout.

보고서를 하나, 둘 또는 세 개의 대상 또는 대상 없음 전혀 보낼 수 있습니다.보고서 모드 또는 모드 및 보고서 파일을 지정 하는 방법에 대 한 자세한 내용은 참조 하십시오 있는 _CrtSetReportMode 및 _CrtSetReportFile 함수.Debug 매크로 사용 하 여 및 보고 기능에 대 한 자세한 내용은 참조 하십시오. 매크로 사용 하 여 확인 및 보고에 대 한.

응용 프로그램에서 제공 하 여 보다 융통성 있게 해야 하는 경우 _CrtDbgReport 및 _CrtDbgReportW, 직접 보고 함수를 작성 하 고 보고 메커니즘을 사용 하 여 C 런타임 라이브러리에 연결 수는 _CrtSetReportHook 함수.

요구 사항

루틴	필수 헤더
_CrtDbgReport	<crtdbg.h>
_CrtDbgReportW	<crtdbg.h>

더 많은 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

라이브러리

디버그 버전의 C 런타임 라이브러리 만 합니다.

예제

// crt_crtdbgreport.c
#include <crtdbg.h>

int main() {
#ifdef _DEBUG
   CrtDbgReport(_CRT_ASSERT, NULL, NULL, "some module", NULL);
#endif
}

참조 하십시오 crt_dbg2 보고서 함수를 변경 하는 방법의 예입니다.

해당 .NET Framework 항목

참고 항목

참조

루틴을 디버깅 합니다.

_CrtSetReportMode

_CrtSetReportFile

printf, _printf_l, wprintf, _wprintf_l

_DEBUG

Share via