WerRegisterAppLocalDump-Funktion (werapi.h)

Registriert einen Pfad (relativ zum LocalFolder der gepackten Anwendung), in dem eine Kopie des Diagnosespeicherabbilds gespeichert werden soll, das Windows-Fehlerberichterstattung (WER) erfasst, wenn einer der Prozesse für die Anwendung nicht mehr reagiert.

Syntax

HRESULT WerRegisterAppLocalDump(
  [in] PCWSTR localAppDataRelativePath
);

Parameter

[in] localAppDataRelativePath

Der Pfad relativ zum lokalen App Store für die aufrufende Anwendung. Hier wird eine Kopie des Diagnosespeicherabbilds gespeichert, das WER sammelt, wenn einer der Prozesse für die Anwendung nicht mehr reagiert. Die maximale Länge für diesen relativen Pfad in Zeichen ist WER_MAX_LOCAL_DUMP_SUBPATH_LENGTH, der den Wert 64 hat. Diese maximale Länge umfasst das NULL-Terminierungszeichen.

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 Prozess kann das Speicherabbild nicht speichern, oder WER kann keinen Speicherort zum Speichern des Speicherabbilds erstellen.
E_INVALIDARG	Der parameter localAppDataRelativePath ist NULL oder ist länger als 64 Zeichen.

Hinweise

Eine gepackte Anwendung ruft WerRegisterAppLocalDump auf, wenn die Anwendung gestartet wird, um eine Kopie des Diagnosespeicherabbilds anzufordern, das WER sammelt, wenn oder wenn einer der Prozesse für die Anwendung nicht mehr reagiert.

WER verwaltet keinen Speicher an dem Speicherort, den der relative Pfad angibt, oder die Anzahl der Speicherabbilder, die für die Anwendung erfasst werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	werapi.h
Bibliothek	Kernel32.lib
DLL	KernelBase.dll

Weitere Informationen

WerUnregisterAppLocalDump-Funktion, Windows-Fehlerberichterstattung