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

こちらもご覧ください

WerReportAddDump 関数、Windows エラー報告