Freigeben über


WER_DUMP_CUSTOM_OPTIONS-Struktur (werapi.h)

Gibt benutzerdefinierte Windows-Fehlerberichterstattung (WER) Minidumpinformationen an, die von der WerReportAddDump-Funktion gesammelt werden sollen.

Syntax

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;

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.

Hinweise

Die in dieser Struktur angegebenen Flags weisen eine direkte Korrelation mit Flags auf, die in der rückruffunktion MINIDUMP_CALLBACK_ROUTINE übergeben werden (siehe MiniDumpWriteDump-Funktion), wenn WER die Dumpdatei generiert.

Wenn der Rückrufeingabetyp des minidump ThreadCallback ist (siehe CallbackType-Member der MINIDUMP_CALLBACK_INPUT-Struktur), wird das ThreadWriteFlags-Elementder MINIDUMP_CALLBACK_OUTPUT-Struktur auf die Flags festgelegt, die in den Elementen dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags oder dwOtherThreadExFlags angegeben sind. Wenn der Rückruf für den abstürzenden Thread gilt, werden die Flags dwExceptionThreadFlags oder dwExceptionThreadExFlags verwendet. Andernfalls werden die Flags dwOtherThreadFlags oder dwOtherThreadExFlags verwendet.

Wenn der Rückrufeingabetyp ModuleCallback ist, wird der ModuleWriteFlags-MemberMINIDUMP_CALLBACK_OUTPUT Struktur auf die Flags festgelegt, die in den Elementen dwPreferredModuleFlags oder dwOtherModuleFlags angegeben sind. Wenn der Rückruf für ein Modul in der Liste der bevorzugten Module gilt, werden die flags dwPreferredModuleFlags verwendet. Andernfalls werden die dwOtherModuleFlags-Flags verwendet.

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, Windows-Fehlerberichterstattung