WerRegisterFile-Funktion (werapi.h)

  • Artikel

Registriert eine Datei, die erfasst werden soll, wenn Windows-Fehlerberichterstattung (WER) einen Fehlerbericht erstellt.

Syntax

HRESULT WerRegisterFile(
  [in] PCWSTR                 pwzFile,
  [in] WER_REGISTER_FILE_TYPE regFileType,
  [in] DWORD                  dwFlags
);

Parameter

[in] pwzFile

Der vollständige Pfad zur Datei. Die maximale Länge dieses Pfads beträgt MAX_PATH Zeichen.

[in] regFileType

Der Dateityp. Dieser Parameter kann einer der folgenden Werte aus dem WER_REGISTER_FILE_TYPE Enumerationstyp sein.

Wert Bedeutung
WerRegFileTypeMax
3 Der maximale Wert für den WER_REGISTER_FILE_TYPE Enumerationstyp.
WerRegFileTypeOther
2 Jeder andere Dateityp.
WerRegFileTypeUserDocument
1 Das Dokument, das von der Anwendung zum Zeitpunkt des Ereignisses verwendet wird. Dieses Dokument wird nur gesammelt, wenn der Watson-Server danach fragt.

[in] dwFlags

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
WER_FILE_ANONYMOUS_DATA Die Datei enthält keine persönlichen Informationen, die zur Identifizierung oder Kontaktaufnahme mit dem Benutzer verwendet werden könnten.
WER_FILE_DELETE_WHEN_DONE Löscht die Datei automatisch, nachdem sie dem Bericht hinzugefügt wurde.

Rückgabewert

Diese Funktion gibt S_OK bei Erfolg oder einen Fehlercode bei Fehler zurück, einschließlich der folgenden Fehlercodes.

Rückgabecode Beschreibung
WER_E_INVALID_STATE Der Prozessstatus ist ungültig. Der Prozess befindet sich beispielsweise im Anwendungswiederherstellungsmodus.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) Die Anzahl der registrierten Speicherblöcke und Dateien überschreitet den Grenzwert.

Hinweise

Die registrierte Datei wird dem Bericht nur hinzugefügt, wenn vom Server zusätzliche Daten angefordert werden.

Bei Abstürze und Nichtantworten stellt das Betriebssystem automatisch Fehlerberichte bereit (Sie müssen keinen Fehlerberichtscode in Ihrer Anwendung angeben). Wenn Sie diese Funktion zum Registrieren einer Datei verwenden, fügt das Betriebssystem die Datei dem Fehlerbericht hinzu, der zum Zeitpunkt eines Absturzes oder einer Nichtantwort erstellt wurde (diese Datei wird zusätzlich zu den Dateien hinzugefügt, die das Betriebssystem bereits sammelt).

Für die generische Ereignisberichterstattung muss die Anwendung stattdessen die Funktion WerReportAddFile verwenden. Alternativ dazu enthält das Aufrufen der WerReportSubmit-Funktion mit dem WER_SUBMIT_ADD_REGISTERED_DATA-Flag die Dateien, die von der WerRegisterFile-Funktion hinzugefügt wurden.

Um die Datei aus der Liste zu entfernen, rufen Sie die Funktion WerUnregisterFile auf.

Anforderungen

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

Siehe auch

WerUnregisterFile, Windows-Fehlerberichterstattung