PSHED_PI_CLEAR_ERROR_RECORD fonction de rappel (ntddk.h)

Article
02/29/2024

La fonction de rappel ClearErrorRecord d’un plug-in PSHED efface l’enregistrement d’erreur spécifié du stockage de données persistantes 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 membre Context de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET lorsque le plug-in PSHED a appelé la fonction PshedRegisterPlugin pour s’inscrire auprès du PSHED.

[in] Flags

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

[in] ErrorRecordId

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

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	L’enregistrement d’erreur a été correctement effacé du stockage de données persistantes du système.
STATUS_UNSUCCESSFUL	Une erreur est survenue.

Remarques

Un plug-in PSHED qui participe à la persistance des enregistrements d’erreurs définit les membres Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord et Callbacks.ClearErrorRecord de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET pour pointer vers ses fonctions de rappel WriteErrorRecord, ReadErrorRecord et 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 le membre FunctionalAreaMask de la structure WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

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