WER_DUMP_CUSTOM_OPTIONS 구조체(werapi.h)
WerReportAddDump 함수에서 수집할 WER(사용자 지정 Windows 오류 보고) 미니덤프 정보를 지정합니다.
구문
typedef struct _WER_DUMP_CUSTOM_OPTIONS {
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];
} WER_DUMP_CUSTOM_OPTIONS, *PWER_DUMP_CUSTOM_OPTIONS;
멤버
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 포함된 경우에만 유효합니다.
설명
이 구조체에 지정된 플래그는 WER이 덤프 파일을 생성할 때 MINIDUMP_CALLBACK_ROUTINE 콜백 함수 콜백 함수( MiniDumpWriteDump 함수 참조)에 전달된 플래그와 직접적인 상관 관계를 갖습니다.
미니덤프의 콜백 입력 형식이 ThreadCallback(MINIDUMP_CALLBACK_INPUT 구조체의 CallbackType 멤버 참조)인 경우 MINIDUMP_CALLBACK_OUTPUT 구조체의 ThreadWriteFlags 멤버는 dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags 또는 dwOtherThreadExFlags 멤버에 지정된 플래그로 설정됩니다. 크래시 스레드에 대한 콜백인 경우 dwExceptionThreadFlags 또는 dwExceptionThreadExFlags 플래그가 사용됩니다. 그렇지 않으면 dwOtherThreadFlags 또는 dwOtherThreadExFlags 플래그가 사용됩니다.
콜백 입력 형식이 ModuleCallback이면 MINIDUMP_CALLBACK_OUTPUT 구조체의 ModuleWriteFlags 멤버가 dwPreferredModuleFlags 또는 dwOtherModuleFlags 멤버에 지정된 플래그로 설정됩니다. 기본 설정 모듈 목록의 모듈에 대한 콜백인 경우 dwPreferredModuleFlags 플래그가 사용됩니다. 그렇지 않으면 dwOtherModuleFlags 플래그가 사용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | werapi.h |