WER_DUMP_CUSTOM_OPTIONS構造体 (werapi.h)
WerReportAddDump 関数によって収集されるカスタム Windows エラー報告 (WER) ミニダンプ情報を指定します。
構文
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
この構造体で有効なオプションを制御するマスク。 次の値の 1 つ以上を指定できます。
- 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
ミニダンプに含める型情報。 1 つ以上の MINIDUMP_TYPE フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_DUMPTYPEが含まれている場合にのみ有効です。
bOnlyThisThread
このメンバーが TRUE で、dwMask にWER_DUMP_MASK_ONLY_THISTHREADが含まれている場合、ミニダンプは呼び出し元のスレッドに対してのみ収集されます。
dwExceptionThreadFlags
ミニダンプに含めるスレッド情報の種類。 1 つ以上の THREAD_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_THREADFLAGSが含まれている場合にのみ有効です。
dwOtherThreadFlags
ミニダンプに含めるスレッド情報の種類。 1 つ以上の THREAD_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_OTHERTHREADFLAGSが含まれている場合にのみ有効です。
dwExceptionThreadExFlags
ミニダンプに含めるスレッド情報の種類。 1 つ以上の THREAD_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_THREADFLAGS_EXが含まれている場合にのみ有効です。
dwOtherThreadExFlags
ミニダンプに含めるスレッド情報の種類。 1 つ以上の THREAD_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_OTHERTHREADFLAGS_EXが含まれている場合にのみ有効です。
dwPreferredModuleFlags
wzPreferredModuleList メンバーで指定されたモジュールのミニダンプに含めるモジュール情報の種類。 1 つ以上の MODULE_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_PREFERRED_MODULESFLAGSが含まれている場合にのみ有効です。
dwOtherModuleFlags
ミニダンプに含めるモジュール情報の種類。 1 つ以上の MODULE_WRITE_FLAGS フラグを指定できます。
このメンバーは、 dwMask にWER_DUMP_MASK_OTHER_MODULESFLAGSが含まれている場合にのみ有効です。
wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]
dwPreferredModuleFlags フラグが適用されるモジュール名の一覧 (パスは含まれません)。 各名前は null で終わる必要があり、リストは 2 つの 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 [デスクトップ アプリのみ] |
| Header | werapi.h |