Condividi tramite


PSHED_PI_CLEAR_ERROR_RECORD funzione di callback (ntddk.h)

Un plug-in PSHED ClearErrorRecord funzione di callback cancella il record di errore specificato dall'archivio 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 Context membro della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlug in per registrarsi con PSHED.

[in] Flags

Combinazione OR'ed bit-wise di flag che influiscono sull'operazione di cancellazione. Nessun flag è attualmente definito.

[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

Un plug-in PSHED ClearErrorRecord funzione di callback 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.

Osservazioni

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

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

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

Vedere anche

PshedRegisterPlugin

ReadErrorRecord

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET

WriteErrorRecord