WerReportAddFile-Funktion (werapi.h)

Artikel
03/06/2024

Fügt dem angegebenen WER-Bericht (Windows-Fehlerberichterstattung) eine Datei hinzu.

Syntax

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Parameter

[in] hReportHandle

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

[in] pwzPath

Ein Zeiger auf eine Unicode-Zeichenfolge, die den vollständigen Pfad zur hinzuzufügenden Datei enthält. Dieser Pfad kann Umgebungsvariablen verwenden. Die maximale Länge dieses Pfads beträgt MAX_PATH Zeichen.

[in] repFileType

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

Wert	Bedeutung
WerFileTypeHeapdump	Ein erweiterter Minidump, der zusätzliche Daten wie den Prozessspeicher enthält.
WerFileTypeMicrodump	Ein eingeschränkter Minidump, der nur eine Stapelüberwachung enthält.
WerFileTypeMinidump	Eine Minidumpdatei.
WerFileTypeOther	Jeder andere Dateityp. Diese Datei wird immer der Cab hinzugefügt (aber nur, wenn der Server nach einer Cab fragt).
WerFileTypeUserDocument	Das Dokument, das von der Anwendung zum Zeitpunkt des Ereignisses verwendet wird. Das Dokument wird nur hinzugefügt, wenn der Server nach diesem Dokumenttyp fragt.

[in] dwFileFlags

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 zum Identifizieren oder Kontaktieren des Benutzers verwendet werden könnten.
WER_FILE_DELETE_WHEN_DONE	Löschen Sie die Datei automatisch, nachdem der Bericht übermittelt wurde.

Rückgabewert

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

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Die angegebene Datei ist nicht vorhanden.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Die angegebene Datei ist ein Benutzerdokument und wird in einem verschlüsselten Dateisystem gespeichert. Diese Kombination wird nicht unterstützt.

Hinweise

Obwohl diese Funktion auch zum Hinzufügen von Speicherabbildern (mit bestimmten Flags) zum Fehlerbericht verwendet werden kann, ist die bevorzugte Funktion zum Hinzufügen von Speicherabbildern WerReportAddDump. Sie sollten diese Funktion nur verwenden, wenn Sie den Speicherabbild selbst sammeln und dann dem Bericht hinzufügen möchten.

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

WerReportErstellen, Windows-Fehlerberichterstattung

Freigeben über