PSHED_PI_CLEAR_ERROR_RECORD Rückruffunktion (ntddk.h)

Artikel
02/29/2024

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 Kontextelement der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur angegeben wurde, als das PSHED-Plug-In die PshedRegisterPlugin-Funktion aufgerufen hat, um sich bei PSHED zu registrieren.

[in] Flags

Eine bitweise OR'ed-Kombination von Flags, die sich auf den Clear-Vorgang auswirken. Derzeit 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-Member 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	Ein Fehler ist aufgetreten.

Hinweise

Ein PSHED-Plug-In, das an der Persistenz des Fehlerdatensatzes beteiligt ist, legt die Rückruffunktionen Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord und Callbacks.ClearErrorRecord der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur so fest, dass sie auf die Rückruffunktionen WriteErrorRecord, ReadErrorRecord und ClearErrorRecord verweisen, 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 wird, um an der Persistenz des Fehlerdatensatzes teilzunehmen, ruft das PSHED-Plug-In die ClearErrorRecord-Rückruffunktion des PSHED-Plug-Ins auf, um den Clear-Vorgang auszuführen. Der Mechanismus, der zum Löschen des Fehlerdatensatzes aus dem persistenten Datenspeicher des Systems verwendet wird, ist plattformspezifisch.