WerReportAddFile-Funktion (werapi.h)

  • Artikel

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