PSHED_PI_CLEAR_ERROR_RECORD Rückruffunktion (ntddk.h)

Artikel
02/07/2025

Die ClearErrorRecord Rückruffunktion eines PSHED-Plug-Ins löscht den angegebenen Fehlerdatensatz aus dem persistenten Datenspeicher des Systems.

Syntax

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

NTSTATUS PshedPiClearErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONGLONG ErrorRecordId
)
{...}

Parameter

[in, out, optional] PluginContext

Ein Zeiger auf den Kontextbereich, der im Context Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur angegeben wurde, als das PSHED-Plug-In die PshedRegisterPlugin--Funktion aufgerufen hat, um sich bei der PSHED-Funktion zu registrieren.

[in] Flags

Eine bitweise OR'ed-Kombination aus Flags, die sich auf den klaren Vorgang auswirken. Zurzeit sind keine Flags definiert.

[in] ErrorRecordId

Der Bezeichner des Fehlerdatensatzes, der aus dem persistenten Datenspeicher des Systems gelöscht wird. Dieser Bezeichner sollte mit dem Header.RecordId Mitglied jeder WHEA_ERROR_RECORD Struktur verglichen werden, die in den persistenten Datenspeicher des Systems geschrieben wurde, um den zu löschenden Fehlerdatensatz zu identifizieren.

Rückgabewert

Die ClearErrorRecord Rückruffunktion eines PSHED-Plug-Ins gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Fehlerdatensatz wurde erfolgreich aus dem persistenten Datenspeicher des Systems gelöscht.
STATUS_UNSUCCESSFUL	Fehler.

Bemerkungen

Ein PSHED-Plug-In, das an der Persistenz des Fehlerdatensatzes teilnimmt, legt die Callbacks.WriteErrorRecord-, Callbacks.ReadErrorRecord- und Callbacks.ClearErrorRecord Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur auf punkt WriteErrorRecord, ReadErrorRecordund ClearErrorRecord Rückruffunktionen, wenn das Plug-In die PshedRegisterPlugin--Funktion aufruft, um sich bei PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorRecordPersistence Flag im FunctionalAreaMask Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET Struktur festlegen.

Der Windows-Kernel ruft den PSHED auf, um einen Fehlerdatensatz aus dem persistenten Datenspeicher des Systems zu löschen. Wenn ein PSHED-Plug-In registriert ist, um an der Persistenz des Fehlerdatensatzes teilzunehmen, ruft die PSHED-Plug-In die ClearErrorRecord Rückruffunktion auf, um den eindeutigen Vorgang auszuführen. Der Mechanismus, der verwendet wird, um den Fehlerdatensatz aus dem persistenten Datenspeicher des Systems zu löschen, ist plattformspezifisch.