WER_DUMP_CUSTOM_OPTIONS_V3構造体 (werapi.h)

PssCaptureSnapshot 関数によってバックグラウンドで (プロセスを一時停止せずに) 収集するカスタム Windows エラー報告 (WER) ミニダンプ情報を指定します。

構文

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

この構造体で有効なオプションを制御するマスク。 次の値の 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が含まれている場合にのみ有効です。

dwPreferredModuleResetFlags

wzPreferredModuleList メンバーで指定されたモジュールのミニダンプに含めるモジュール情報の推奨される種類。 1 つ以上の MODULE_WRITE_FLAGS フラグを指定できます。

このメンバーは、 dwMask にWER_DUMP_MASK_PREFERRED_MODULESFLAGSが含まれている場合にのみ有効です。

dwOtherModuleResetFlags

wzPreferredModuleList メンバーで指定されたモジュールのミニダンプに含めるその他の種類のモジュール情報。 1 つ以上の MODULE_WRITE_FLAGS フラグを指定できます。

このメンバーは、 dwMask にWER_DUMP_MASK_PREFERRED_MODULESFLAGSが含まれている場合にのみ有効です。

pvDumpKey

ダンプ キーの値。

hSnapshot

ターゲット プロセス スナップショットに処理します。

dwThreadID

スレッド ID。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	werapi.h

こちらもご覧ください

WerReportAddDump 関数、PssCaptureSnapshot、Windows エラー報告