Share via

WerReportAddDump-Funktion (werapi.h)

  • Artikel

Fügt dem angegebenen WER-Bericht (Windows-Fehlerberichterstattung) ein Dump des angegebenen Typs hinzu.

Syntax

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Parameter

[in] hReportHandle

Ein Handle für den Bericht. Dieses Handle wird von der WerReportCreate-Funktion zurückgegeben.

[in] hProcess

Ein Handle für den Prozess, für den der Bericht generiert wird. Dieses Handle muss über die Zugriffsrechte STANDARD_RIGHTS_READ und PROCESS_QUERY_INFORMATION verfügen.

[in, optional] hThread

Ein Handle für den Thread von hProcess , für den der Bericht generiert wird. Wenn dumpType WerDumpTypeMicro ist, ist dieser Parameter erforderlich. Bei anderen Dumptypen kann dieser Parameter NULL sein.

[in] dumpType

Der Typ des Minidumps. Dieser Parameter kann einer der folgenden Werte aus dem WER_DUMP_TYPE Enumerationstyp sein.

Wert Bedeutung
WerDumpTypeHeapDump
 Ein erweiterter Minidump, der zusätzliche Daten wie den Prozessspeicher enthält.

Dieser Typ entspricht dem Erstellen eines Minidumps mit den folgenden Optionen:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 und höher)
  • MiniDumpWithTokenInformation (Windows 7 und höher)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 und höher)
WerDumpTypeMicroDump
 Ein eingeschränkter Minidump, der nur eine Stapelüberwachung enthält.

Dieser Typ entspricht dem Erstellen eines Minidumps mit den folgenden Optionen:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Ein Minidump.

Dieser Typ entspricht dem Erstellen eines Minidumps mit den folgenden Optionen:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 und höher)

[in, optional] pExceptionParam

Ein Zeiger auf eine WER_EXCEPTION_INFORMATION-Struktur , die Ausnahmeinformationen angibt.

[in, optional] pDumpCustomOptions

Ein Zeiger auf eine WER_DUMP_CUSTOM_OPTIONS-Struktur , die benutzerdefinierte Minidumpoptionen angibt. Wenn dieser Parameter NULL ist, werden die Standard-Minidumpinformationen gesammelt.

[in] dwFlags

Dieser Parameter kann 0 oder der folgende Wert sein.

Wert Bedeutung
WER_DUMP_NOHEAP_ONQUEUE
 Wenn der Bericht in die Warteschlange eingereiht wird, schließen Sie kein Heapabbild ein. Die Verwendung dieses Flags spart Speicherplatz.

Rückgabewert

Diese Funktion gibt S_OK bei Erfolg oder einen Fehlercode bei Einem Fehler zurück.

Hinweise

Verwenden Sie diese Funktion nur für generische Berichte. Sie hat keine Auswirkungen auf die Absturz- oder No-Response-Berichte des Betriebssystems.

Wenn der Server nach einem Miniabbild fragt und Sie WerDumpTypeHeapDump für den dumpType-Parameter angeben, sendet WER das Heapabbild nicht an den Watson-Server. Wenn der Server jedoch nach einem Heapabbild fragt und der dumpTypeWerDumpTypeMiniDump lautet, sendet WER das Miniabbild an den Server. Daher wird empfohlen, dumpType auf WerDumpTypeMiniDump festzulegen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile werapi.h
Bibliothek Wer.lib
DLL Wer.dll

Weitere Informationen

Minidump Files, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Windows-Fehlerberichterstattung