Freigeben über

WerReportSubmit-Funktion (werapi.h)

  • Artikel

Übermittelt den angegebenen Windows-Fehlerberichterstattung (WER)-Bericht.

Syntax

HRESULT WerReportSubmit(
  [in]            HREPORT            hReportHandle,
  [in]            WER_CONSENT        consent,
  [in]            DWORD              dwFlags,
  [out, optional] PWER_SUBMIT_RESULT pSubmitResult
);

Parameter

[in] hReportHandle

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

[in] consent

Die Zustimmung status. Dieser Parameter kann einer der folgenden Werte aus dem WER_CONSENT Enumerationstyp sein.

Wert Bedeutung
WerConsentAlwaysPrompt
4		 Der Benutzer wird immer aufgefordert, die Anforderung zu übermitteln.
WerConsentApproved
2		 Der Benutzer hat die Übermittlungsanforderung genehmigt.
WerConsentDenied
3		 Der Benutzer hat die Übermittlungsanforderung abgelehnt.
WerConsentMax
5		 Der maximale Wert für den WER_CONSENT Enumerationstyp.
WerConsentNotAsked
1		 Der Benutzer wurde nicht um seine Zustimmung gebeten.

[in] dwFlags

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
WER_SUBMIT_ADD_REGISTERED_DATA
16		 Fügen Sie dem Bericht die von WerSetFlags, WerRegisterFile und WerRegisterMemoryBlock registrierten Daten hinzu.
WER_SUBMIT_HONOR_RECOVERY
1		 Berücksichtigen Sie alle Wiederherstellungsregistrierungen für die Anwendung. Weitere Informationen finden Sie unter RegisterApplicationRecoveryCallback.
WER_SUBMIT_HONOR_RESTART
2		 Berücksichtigen Sie alle Neustartregistrierungen für die Anwendung. Weitere Informationen finden Sie unter RegisterApplicationRestart.
WER_SUBMIT_NO_ARCHIVE
256		 Archivieren Sie den Bericht nicht.
WER_SUBMIT_NO_CLOSE_UI
64		 Zeigen Sie das Dialogfeld Schließen für den kritischen Bericht nicht an.
WER_SUBMIT_NO_QUEUE
128		 Stellen Sie den Bericht nicht in die Warteschlange. Wenn eine angemessene Benutzerzustimmung vorliegt, wird der Bericht sofort an Microsoft gesendet. andernfalls wird der Bericht verworfen. Sie können dieses Flag für nicht kritische Berichte verwenden.

Der Bericht wird für alle Aktionen verworfen, für die eine Warteschlange des Berichts erforderlich wäre. Wenn der Computer beispielsweise offline ist, wenn Sie den Bericht übermitteln, wird der Bericht verworfen. Außerdem wird der Bericht verworfen, wenn eine unzureichende Zustimmung vorliegt (z. B. war die Zustimmung für den Datenteil des Berichts erforderlich).
WER_SUBMIT_OUTOFPROCESS
32		 Führen Sie einen weiteren Prozess zum Übermitteln des Berichts durch. Der aufrufende Thread wird blockiert, bis die Funktion zurückgegeben wird.

HINWEIS: Fenstermeldungen werden gepumpt, sodass die UI-Aktivität im aufrufenden Thread nicht blockiert wird.
WER_SUBMIT_OUTOFPROCESS_ASYNC
1024		 Führen Sie einen weiteren Prozess aus, um den Bericht zu übermitteln und von diesem Funktionsaufruf sofort zurückzugeben. Beachten Sie, dass der Inhalt des pSubmitResult-Parameters nicht definiert ist und es keine Möglichkeit gibt, abfragen zu können, wann die Berichterstellung abgeschlossen ist oder die Vervollständigung status.
WER_SUBMIT_QUEUE
4		 Fügen Sie den Bericht der WER-Warteschlange hinzu, ohne den Benutzer zu benachrichtigen. Der Bericht wird nur in die Warteschlange gestellt. Die Berichterstellung (Senden des Berichts an Microsoft) erfolgt später basierend auf der Zustimmungsebene des Benutzers.
WER_SUBMIT_SHOW_DEBUG
8		 Zeigen Sie die Debugschaltfläche an.
WER_SUBMIT_START_MINIMIZED
512		 Die anfängliche Benutzeroberfläche wird minimiert und blinkt.
WER_SUBMIT_BYPASS_DATA_THROTTLING
2048		 Umgehen sie die Datendrosselung für den Bericht.

Windows 7 oder früher: Dieser Parameter ist nicht verfügbar.
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY
4096		 Archivieren Sie nur die Parameter. die Kabine wird verworfen. Dieses Flag überschreibt die Einstellung ConfigureArchive WER.

Windows 7 oder früher: Dieser Parameter ist nicht verfügbar.
WER_SUBMIT_REPORT_MACHINE_ID
8192		 Senden Sie immer den eindeutigen 128-Bit-Computerbezeichner mit dem Bericht, unabhängig von der Zustimmung, mit der der Bericht übermittelt wurde. Weitere Informationen finden Sie unter Hinweise.

Windows 7 oder früher: Dieser Parameter ist nicht verfügbar.

[out, optional] pSubmitResult

Das Ergebnis der Übermittlung. Dieser Parameter kann einer der folgenden Werte aus dem WER_SUBMIT_RESULT Enumerationstyp sein.

Wert Bedeutung
WerCustomAction
9		 Die Fehlerberichterstattung kann angepasst werden.
WerDisabled
5		 Die Fehlerberichterstattung wurde deaktiviert.
WerDisabledQueue
7		 Warteschlangen waren deaktiviert.
WerReportAsync
8		 Der Bericht war asynchron.
WerReportCancelled
6		 Der Bericht wurde abgebrochen.
WerReportDebug
3		 Auf die Schaltfläche Debuggen wurde geklickt.
WerReportFailed
4		 Fehler bei der Berichtsübermittlung.
WerReportQueued
1		 Der Bericht wurde in die Warteschlange eingereiht.
WerReportUploaded
2		 Der Bericht wurde hochgeladen.

Rückgabewert

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

Hinweise

Nachdem die Anwendung diese Funktion aufgerufen hat, sammelt WER die angegebenen Daten. Wenn der Consent-Parameter WerConsentApproved lautet, wird der Bericht an Microsoft übermittelt. Wenn die Zustimmung WerConsentNotAsked lautet, zeigt WER das Dialogfeld "Einwilligung" an. Überprüfen Sie den pSubmitResult-Parameter, um die übermittlungs-status zu bestimmen.

Im Falle eines kritischen Anwendungsereignisses werden Anwendungen, die sich für den Neustart registriert haben, neu gestartet.

Der Computerbezeichner wird zusammen mit dem Bericht gesendet, wenn:

  • Die Zum Senden des Berichts verwendete Zustimmung stammt nicht von der Anwendung. Beispielsweise wurde der Bericht mit zustimmung übermittelt status auf WerConsentNotAsked festgelegt.
  • Der Bericht wurde mit festgelegtem WER_SUBMIT_REPORT_MACHINE_ID-Flag übermittelt.

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