WerRegisterMemoryBlock-Funktion (werapi.h)

  • Artikel

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

WerUnregisterMemoryBlock, Windows-Fehlerberichterstattung