다음을 통해 공유

WerReportAddDump 함수(werapi.h)

  • 아티클

지정된 형식의 덤프를 지정된 WER(Windows 오류 보고) 보고서에 추가합니다.

구문

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

매개 변수

[in] hReportHandle

보고서에 대한 핸들입니다. 이 핸들은 WerReportCreate 함수에 의해 반환됩니다.

[in] hProcess

보고서가 생성되는 프로세스에 대한 핸들입니다. 이 핸들에는 STANDARD_RIGHTS_READ 및 PROCESS_QUERY_INFORMATION 액세스 권한이 있어야 합니다.

[in, optional] hThread

보고서가 생성되는 hProcess 스레드에 대한 핸들입니다. dumpType이 WerDumpTypeMicro이면 이 매개 변수가 필요합니다. 다른 덤프 형식의 경우 이 매개 변수는 NULL일 수 있습니다.

[in] dumpType

미니덤프의 형식입니다. 이 매개 변수는 WER_DUMP_TYPE 열거형 형식의 다음 값 중 하나일 수 있습니다.

값 의미
WerDumpTypeHeapDump
 프로세스 메모리와 같은 추가 데이터를 포함하는 확장된 미니덤프입니다.

이 형식은 다음 옵션을 사용하여 미니덤프를 만드는 것과 같습니다.

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo(Windows 7 이상)
  • MiniDumpWithTokenInformation(Windows 7 이상)
  • MiniDumpWithPrivateWriteCopyMemory(Windows 7 이상)
WerDumpTypeMicroDump
 스택 추적만 포함하는 제한된 미니덤프입니다.

이 형식은 다음 옵션을 사용하여 미니덤프를 만드는 것과 같습니다.

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 미니덤프.

이 형식은 다음 옵션을 사용하여 미니덤프를 만드는 것과 같습니다.

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation(Windows 7 이상)

[in, optional] pExceptionParam

예외 정보를 지정하는 WER_EXCEPTION_INFORMATION 구조체에 대한 포인터입니다.

[in, optional] pDumpCustomOptions

사용자 지정 미니덤프 옵션을 지정하는 WER_DUMP_CUSTOM_OPTIONS 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 표준 미니덤프 정보가 수집됩니다.

[in] dwFlags

이 매개 변수는 0 또는 다음 값일 수 있습니다.

값 의미
WER_DUMP_NOHEAP_ONQUEUE
 보고서가 큐에 대기 중인 경우 힙 덤프를 포함하지 마세요. 이 플래그를 사용하면 디스크 공간이 절약됩니다.

반환 값

이 함수는 성공 시 S_OK 반환하거나 실패 시 오류 코드를 반환합니다.

설명

이 함수는 일반 보고에만 사용합니다. 운영 체제 크래시 또는 응답 없음 보고에는 영향을 주지 않습니다.

서버가 미니 덤프를 요청하고 dumpType 매개 변수에 대해 WerDumpTypeHeapDump를 지정하는 경우 WER은 Watson 서버에 힙 덤프를 보내지 않습니다. 그러나 서버가 힙 덤프를 요청하고 dumpType 이 WerDumpTypeMiniDump인 경우 WER은 미니 덤프를 서버에 보냅니다. 따라서 dumpType 을 WerDumpTypeMiniDump로 설정하는 것이 좋습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 werapi.h
라이브러리 Wer.lib
DLL Wer.dll

추가 정보

Minidump 파일, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Windows 오류 보고