WerReportCreate-Funktion (werapi.h)

  • Artikel

Erstellt einen Windows-Fehlerberichterstattung (WER)-Bericht, der ein Anwendungsereignis beschreibt.

Syntax

HRESULT WerReportCreate(
  [in]           PCWSTR                  pwzEventType,
  [in]           WER_REPORT_TYPE         repType,
  [in, optional] PWER_REPORT_INFORMATION pReportInformation,
  [out]          HREPORT                 *phReportHandle
);

Parameter

[in] pwzEventType

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Ereignisses angibt.

[in] repType

Der Berichtstyp. Dieser Parameter kann einer der folgenden Werte aus dem WER_REPORT_TYPE Enumerationstyp sein.

Wert Bedeutung
WerReportApplicationCrash
2		 Es ist ein Fehler aufgetreten, der dazu geführt hat, dass die Anwendung nicht mehr ausgeführt wird.
WerReportApplicationHang
3		 Es ist ein Fehler aufgetreten, der dazu geführt hat, dass die Anwendung nicht mehr reagiert.
WerReportInvalid
5		 Es ist ein Fehler aufgetreten, der eine ungültige Rückgabe aufgerufen hat.
WerReportKernel
4		 Im Kernel ist ein Fehler aufgetreten.
WerReportCritical
1		 Ein kritischer Fehler, z. B. ein Absturz oder eine Nichtantwort, ist aufgetreten. Standardmäßig werden Prozesse, bei denen ein kritischer Fehler auftritt, beendet oder neu gestartet.
WerReportNonCritical
0		 Es ist ein fehler aufgetreten, der nicht kritisch ist. Dieser Berichtstyp zeigt keine Benutzeroberfläche an. Der Bericht wird unbeaufsichtigt in die Warteschlange eingereiht. Es kann dann unbeaufsichtigt an den Server im Hintergrund gesendet werden, wenn eine angemessene Benutzerzustimmung verfügbar ist.

[in, optional] pReportInformation

Ein Zeiger auf eine WER_REPORT_INFORMATION Struktur, die Informationen für den Bericht angibt.

[out] phReportHandle

Ein Handle für den Bericht. Wenn die Funktion fehlschlägt, ist dieses Handle NULL.

Rückgabewert

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

Hinweise

Verwenden Sie die folgenden Funktionen, um zusätzliche Informationen anzugeben, die übermittelt werden sollen:

Um die Informationen zu übermitteln, rufen Sie die Funktion WerReportSubmit auf. Wenn Sie mit dem Berichtshandle fertig sind, rufen Sie die Funktion WerReportCloseHandle auf.

Anwendungen können auch angeben, dass sie die Möglichkeit haben möchten, Daten wiederherzustellen oder bei einem Fehler neu zu starten. Weitere Informationen finden Sie unter Anwendungswiederherstellung und Neustart.

Um die von Ihrer Anwendung übermittelten Berichte anzuzeigen, wechseln Sie zu Windows Quality Online Services.

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

Anwendungswiederherstellung und -neustart, WER_REPORT_INFORMATION, WerReportCloseHandle, WerReportSubmit, Windows-Fehlerberichterstattung