PSHED_PI_CLEAR_ERROR_RECORD função de retorno de chamada (ntddk.h)

Artigo
03/05/2024

A função de retorno de chamada ClearErrorRecord de um plug-in PSHED limpa o registro de erro especificado do armazenamento de dados persistente do sistema.

Sintaxe

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

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

Parâmetros

[in, out, optional] PluginContext

Um ponteiro para a área de contexto especificada no membro Context da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando o plug-in PSHED chamou a função PshedRegisterPlugin para se registrar no PSHED.

[in] Flags

Uma combinação or'ed bit-wise de sinalizadores que afetam a operação clara. Nenhum sinalizador está definido no momento.

[in] ErrorRecordId

O identificador do registro de erro que está sendo limpo do armazenamento de dados persistente do sistema. Esse identificador deve ser comparado ao membro Header.RecordId de cada estrutura WHEA_ERROR_RECORD que foi gravada no armazenamento de dados persistente do sistema para identificar o registro de erro a ser limpo.

Retornar valor

A função de retorno de chamada ClearErrorRecord de um plug-in PSHED retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O registro de erro foi limpo com êxito do armazenamento de dados persistente do sistema.
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Comentários

Um plug-in PSHED que participa da persistência do registro de erro define o Callbacks.WriteErrorRecord, Os membros Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para suas funções de retorno de chamada WriteErrorRecord, ReadErrorRecord e ClearErrorRecord quando o plug-in chama a função PshedRegisterPlugin para se registrar no PSHED. O plug-in PSHED também deve definir o sinalizador PshedFAErrorRecordPersistence no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

O kernel do Windows chama o PSHED para limpar um registro de erro do armazenamento de dados persistente do sistema. Se um plug-in PSHED estiver registrado para participar da persistência do registro de erro, o PSHED chamará a função de retorno de chamada ClearErrorRecord do plug-in PSHED para executar a operação clara. O mecanismo usado para limpar o registro de erro do armazenamento de dados persistente do sistema é específico da plataforma.