WER_DUMP_CUSTOM_OPTIONS_V3 구조체(werapi.h)

PssCaptureSnapshot 함수에서 백그라운드에서 수집할 WER(사용자 지정 Windows 오류 보고) 미니덤프 정보를 지정합니다(프로세스를 일시 중지하지 않음).

구문

typedef struct _WER_DUMP_CUSTOM_OPTIONS_V3 {
  DWORD  dwSize;
  DWORD  dwMask;
  DWORD  dwDumpFlags;
  BOOL   bOnlyThisThread;
  DWORD  dwExceptionThreadFlags;
  DWORD  dwOtherThreadFlags;
  DWORD  dwExceptionThreadExFlags;
  DWORD  dwOtherThreadExFlags;
  DWORD  dwPreferredModuleFlags;
  DWORD  dwOtherModuleFlags;
  WCHAR  wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER];
  DWORD  dwPreferredModuleResetFlags;
  DWORD  dwOtherModuleResetFlags;
  PVOID  pvDumpKey;
  HANDLE hSnapshot;
  DWORD  dwThreadID;
} WER_DUMP_CUSTOM_OPTIONS_V3, *PWER_DUMP_CUSTOM_OPTIONS_V3;

멤버

dwSize

구조체의 크기(바이트)입니다.

dwMask

이 구조체에서 유효한 옵션을 제어하는 마스크입니다. 다음 값 중 하나 이상을 지정할 수 있습니다.

• WER_DUMP_MASK_DUMPTYPE
• WER_DUMP_MASK_ONLY_THISTHREAD
• WER_DUMP_MASK_OTHER_MODULESFLAGS
• WER_DUMP_MASK_OTHERTHREADFLAGS
• WER_DUMP_MASK_OTHERTHREADFLAGS_EX
• WER_DUMP_MASK_PREFERRED_MODULE_LIST
• WER_DUMP_MASK_PREFERRED_MODULESFLAGS
• WER_DUMP_MASK_THREADFLAGS
• WER_DUMP_MASK_THREADFLAGS_EX

dwDumpFlags

미니덤프에 포함할 형식 정보입니다. 하나 이상의 MINIDUMP_TYPE 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_DUMPTYPE 포함하는 경우에만 유효합니다.

bOnlyThisThread

이 멤버가 TRUE 이고 dwMask 에 WER_DUMP_MASK_ONLY_THISTHREAD 포함된 경우 미니덤프는 호출 스레드에 대해서만 수집됩니다.

dwExceptionThreadFlags

미니덤프에 포함할 스레드 정보의 형식입니다. 하나 이상의 THREAD_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_THREADFLAGS 포함하는 경우에만 유효합니다.

dwOtherThreadFlags

미니덤프에 포함할 스레드 정보의 형식입니다. 하나 이상의 THREAD_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_OTHERTHREADFLAGS 포함하는 경우에만 유효합니다.

dwExceptionThreadExFlags

미니덤프에 포함할 스레드 정보의 형식입니다. 하나 이상의 THREAD_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_THREADFLAGS_EX 포함된 경우에만 유효합니다.

dwOtherThreadExFlags

미니덤프에 포함할 스레드 정보의 형식입니다. 하나 이상의 THREAD_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_OTHERTHREADFLAGS_EX 포함하는 경우에만 유효합니다.

dwPreferredModuleFlags

wzPreferredModuleList 멤버에 지정된 모듈의 미니덤프에 포함할 모듈 정보의 형식입니다. 하나 이상의 MODULE_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_PREFERRED_MODULESFLAGS 포함하는 경우에만 유효합니다.

dwOtherModuleFlags

미니덤프에 포함할 모듈 정보의 형식입니다. 하나 이상의 MODULE_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_OTHER_MODULESFLAGS 포함하는 경우에만 유효합니다.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

dwPreferredModuleFlags 플래그가 적용되는 모듈 이름 목록(경로를 포함하지 않음)입니다. 각 이름은 null로 종료되어야 하며 목록은 두 개의 null 문자(예: module1.dll\0module2.dll\0\0)로 종료되어야 합니다.

모든 모듈이 선호되도록 지정하려면 이 멤버를 로 *\0\0설정합니다. 목록에 다른 모듈 이름을 포함하는 * 경우 는 * 무시됩니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_PREFERRED_MODULE_LIST 포함하는 경우에만 유효합니다.

dwPreferredModuleResetFlags

wzPreferredModuleList 멤버에 지정된 모듈의 미니덤프에 포함할 기본 형식의 모듈 정보입니다. 하나 이상의 MODULE_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_PREFERRED_MODULESFLAGS 포함하는 경우에만 유효합니다.

dwOtherModuleResetFlags

wzPreferredModuleList 멤버에 지정된 모듈의 미니덤프에 포함할 다른 유형의 모듈 정보입니다. 하나 이상의 MODULE_WRITE_FLAGS 플래그를 지정할 수 있습니다.

이 멤버는 dwMask 에 WER_DUMP_MASK_PREFERRED_MODULESFLAGS 포함하는 경우에만 유효합니다.

pvDumpKey

덤프 키 값입니다.

hSnapshot

대상 프로세스 스냅샷 대한 핸들입니다.

dwThreadID

스레드 ID입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	werapi.h

추가 정보

WerReportAddDump 함수, PssCaptureSnapshot, Windows 오류 보고