WerRegisterMemoryBlock-Funktion (werapi.h)
Registriert einen Speicherblock, der erfasst werden soll, wenn Windows-Fehlerberichterstattung (WER) einen Fehlerbericht erstellt.
Syntax
HRESULT WerRegisterMemoryBlock(
[in] PVOID pvAddress,
[in] DWORD dwSize
);
Parameter
[in] pvAddress
Die Startadresse des Speicherblocks.
[in] dwSize
Die Größe des Speicherblocks in Bytes. Der maximale Wert für diesen Parameter beträgt WER_MAX_MEM_BLOCK_SIZE Bytes.
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
Arbeitsspeicher, der mit dieser Funktion registriert ist, wird nur zu Heap- oder größeren Speicherabbilddateien hinzugefügt. Dieser Arbeitsspeicher wird niemals Miniabbildern oder kleineren Speicherabbildern hinzugefügt.
Für Abstürze und keine Antwort stellt das Betriebssystem automatisch fehlerberichterstattung bereit (Sie müssen keinen Fehlerberichtscode in Ihrer Anwendung angeben). Wenn Sie diese Funktion zum Registrieren eines Speicherblocks verwenden, fügt das Betriebssystem die Speicherblockinformationen zur Speicherabbilddatei zum Zeitpunkt des Absturzes oder der Nichtantwort hinzu. Der Speicherblock wird der Speicherabbilddatei für den Bericht nur hinzugefügt, wenn vom Server zusätzliche Daten angefordert werden.
Für die generische Ereignisberichterstattung muss die Anwendung die generischen WER-Ereignisberichtsfunktionen direkt aufrufen. Um den Speicherblock zu einem generischen Bericht hinzuzufügen, rufen Sie die WerReportAddDump-Funktion und dann die WerReportSubmit-Funktion auf, und geben Sie das flag WER_SUBMIT_ADD_REGISTERED_DATA an.
Um den Block aus dieser Liste zu entfernen, rufen Sie die WerUnregisterMemoryBlock-Funktion 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für