PSHED_PI_CLEAR_ERROR_RECORD fonction de rappel (ntddk.h)

Article
02/07/2025

Un plug-in PSHED ClearErrorRecord fonction de rappel efface l’enregistrement d’erreur spécifié du stockage de données persistant du système.

Syntaxe

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

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

Paramètres

[in, out, optional] PluginContext

Pointeur vers la zone de contexte spécifiée dans le Context membre de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET lorsque le plug-in PSHED appelé PshedRegisterPlugin fonction pour s’inscrire auprès du PSHED.

[in] Flags

Combinaison or’ed bit des indicateurs qui affectent l’opération claire. Aucun indicateur n’est actuellement défini.

[in] ErrorRecordId

Identificateur de l’enregistrement d’erreur qui est effacé du stockage de données persistant du système. Cet identificateur doit être comparé au Header.RecordId membre de chaque structure de WHEA_ERROR_RECORD qui a été écrite dans le stockage de données persistant du système pour identifier l’enregistrement d’erreur à effacer.

Valeur de retour

Un plug-in PSHED ClearErrorRecord fonction de rappel retourne l’un des codes NTSTATUS suivants :

Retourner le code	Description
STATUS_SUCCESS	L’enregistrement d’erreur a été effacé du stockage de données persistant du système.
STATUS_UNSUCCESSFUL	Une erreur s’est produite.

Remarques

Un plug-in PSHED qui participe à la persistance des enregistrements d’erreur définit les Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord et Callbacks.ClearErrorRecord membres de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET à pointer vers son WriteErrorRecord, ReadErrorRecordet fonctions de rappel ClearErrorRecord lorsque le plug-in appelle la fonction PshedRegisterPlugin pour s’inscrire auprès du PSHED. Le plug-in PSHED doit également définir l’indicateur PshedFAErrorRecordPersistence dans l’indicateur FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Le noyau Windows appelle le PSHED pour effacer un enregistrement d’erreur à partir du stockage de données persistant du système. Si un plug-in PSHED est inscrit pour participer à la persistance des enregistrements d’erreur, le PSHED appelle le plug-in PSHED ClearErrorRecord fonction de rappel pour effectuer l’opération d’effacement. Le mécanisme utilisé pour effacer l’enregistrement d’erreur du stockage de données persistants du système est spécifique à la plateforme.