WerRegisterExcludedMemoryBlock-Funktion (werapi.h)

Markiert einen Speicherblock (der normalerweise standardmäßig in Fehlerberichten enthalten ist), der aus dem Fehlerbericht Windows-Fehlerberichterstattung (WER) ausgeschlossen werden soll.

Syntax

HRESULT WerRegisterExcludedMemoryBlock(
  const void *address,
  DWORD      size
);

Parameter

address

Die Startadresse des Speicherblocks.

size

Die Größe des Speicherblocks in 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
E_INVALIDARG	address ist NULL oder Größe ist 0.
E_OUTOFMEMORY	WER konnte keinen ausreichend großen Heap für die Daten zuordnen.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Die Anzahl der registrierten Einträge überschreitet den Grenzwert (WER_MAX_REGISTERED_ENTRIES).
WER_E_INVALID_STATE	Der Prozessstatus ist ungültig. Der Prozess befindet sich beispielsweise im Anwendungswiederherstellungsmodus.

Hinweise

Dieser Mechanismus ist für Anwendungen vorgesehen, die große Datenmengen im Arbeitsspeicher enthalten, die für das Debuggen der Grundursache nicht nützlich sind und die Größe der Speicherabbilddatei unnötig erhöhen. Beispielsweise enthalten einige Spiele große Mengen von Texturdaten im Arbeitsspeicher, die standardmäßig in Fehlerabbildern enthalten sind.

Anforderungen

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

Siehe auch

WerUnregisterExcludedMemoryBlock, Windows-Fehlerberichterstattung