WER_DUMP_CUSTOM_OPTIONS_V3-Struktur (werapi.h)

Gibt benutzerdefinierte Windows-Fehlerberichterstattung -Minidumpinformationen (WER) an, die von der PssCaptureSnapshot-Funktion im Hintergrund erfasst werden sollen (ohne den Prozess anzuhalten).

Syntax

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;

Member

dwSize

Die Größe der Struktur in Bytes.

dwMask

Eine Maske, die steuert, welche Optionen in dieser Struktur gültig sind. Sie können einen oder mehrere der folgenden Werte angeben:

• 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

Die Typinformationen, die in den Minidump eingeschlossen werden sollen. Sie können mindestens eins der MINIDUMP_TYPE-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_DUMPTYPE enthält.

bOnlyThisThread

Wenn dieser Member TRUE ist und dwMask WER_DUMP_MASK_ONLY_THISTHREAD enthält, soll der Minidump nur für den aufrufenden Thread erfasst werden.

dwExceptionThreadFlags

Der Typ der Threadinformationen, die in den Minidump eingeschlossen werden sollen. Sie können ein oder mehrere der THREAD_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_THREADFLAGS enthält.

dwOtherThreadFlags

Der Typ der Threadinformationen, die in den Minidump eingeschlossen werden sollen. Sie können ein oder mehrere der THREAD_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_OTHERTHREADFLAGS enthält.

dwExceptionThreadExFlags

Der Typ der Threadinformationen, die in den Minidump eingeschlossen werden sollen. Sie können ein oder mehrere der THREAD_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_THREADFLAGS_EX enthält.

dwOtherThreadExFlags

Der Typ der Threadinformationen, die in den Minidump eingeschlossen werden sollen. Sie können ein oder mehrere der THREAD_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_OTHERTHREADFLAGS_EX enthält.

dwPreferredModuleFlags

Der Typ der Modulinformationen, die in den Minidump für Module aufgenommen werden sollen, die im wzPreferredModuleList-Element angegeben sind. Sie können eines oder mehrere der MODULE_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_PREFERRED_MODULESFLAGS enthält.

dwOtherModuleFlags

Der Typ der Modulinformationen, die in den Minidump aufgenommen werden sollen. Sie können eines oder mehrere der MODULE_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_OTHER_MODULESFLAGS enthält.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

Eine Liste von Modulnamen (ohne pfad), auf die die dwPreferredModuleFlags-Flags angewendet werden. Jeder Name muss NULL-endend sein, und die Liste muss mit zwei NULL-Zeichen beendet werden (z. B. module1.dll\0module2.dll\0\0).

Um anzugeben, dass alle Module bevorzugt werden, legen Sie diesen Member auf fest *\0\0. Wenn Sie in eine Liste mit anderen Modulnamen einschließen * , wird ignoriert * .

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_PREFERRED_MODULE_LIST enthält.

dwPreferredModuleResetFlags

Der bevorzugte Typ von Modulinformationen, die in den Minidump für Module aufgenommen werden sollen, die im wzPreferredModuleList-Element angegeben sind. Sie können eines oder mehrere der MODULE_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_PREFERRED_MODULESFLAGS enthält.

dwOtherModuleResetFlags

Andere Typen von Modulinformationen, die in den Minidump für Module aufgenommen werden sollen, die im wzPreferredModuleList-Element angegeben sind. Sie können eines oder mehrere der MODULE_WRITE_FLAGS-Flags angeben.

Dieser Member ist nur gültig, wenn dwMask WER_DUMP_MASK_PREFERRED_MODULESFLAGS enthält.

pvDumpKey

Der Wert des Speicherabbildschlüssels.

hSnapshot

Handle an den Zielprozess Momentaufnahme.

dwThreadID

Die Thread-ID.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	werapi.h

Weitere Informationen

WerReportAddDump-Funktion, PssCaptureSnapshot, Windows-Fehlerberichterstattung