PSHED_PI_CLEAR_ERROR_RECORD Rückruffunktion (ntddk.h)

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:

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.

Anforderungen

Siehe auch

PshedRegisterPlugin

ReadErrorRecord-

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET

WriteErrorRecord-