PSHED_PI_CLEAR_ERROR_RECORD funzione di callback (ntddk.h)

Articolo
02/29/2024

La funzione di callback ClearErrorRecord di un plug-in PSHED cancella il record di errore specificato dall'archiviazione dati permanente del sistema.

Sintassi

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

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

Parametri

[in, out, optional] PluginContext

Puntatore all'area di contesto specificata nel membro Context della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlugin per registrarsi con PSHED.

[in] Flags

Combinazione OR'ed bit per bit di flag che influiscono sull'operazione di cancellazione. Non sono attualmente definiti flag.

[in] ErrorRecordId

Identificatore del record di errore che viene cancellato dall'archivio dati permanente del sistema. Questo identificatore deve essere confrontato con il membro Header.RecordId di ogni struttura WHEA_ERROR_RECORD scritta nell'archivio dati permanente del sistema per identificare il record di errore da cancellare.

Valore restituito

Una funzione di callback ClearErrorRecord di un plug-in PSHED restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il record di errore è stato cancellato correttamente dall'archivio dati permanente del sistema.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Commenti

Un plug-in PSHED che partecipa alla persistenza dei record di errore imposta i membri Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET in modo che puntino alle relative funzioni di callback WriteErrorRecord, ReadErrorRecord e ClearErrorRecord quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag PshedFAErrorRecordPersistence nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Il kernel di Windows chiama pshed per cancellare un record di errore dall'archivio dati permanente del sistema. Se un plug-in PSHED viene registrato per partecipare alla persistenza dei record di errore, PSHED chiama la funzione di callback ClearErrorRecord del plug-in PSHED per eseguire l'operazione non crittografata. Il meccanismo usato per cancellare il record di errore dall'archivio dati permanente del sistema è specifico della piattaforma.