PSHED_PI_CLEAR_ERROR_RECORD função de retorno de chamada (ntddk.h)
O ClearErrorRecord de um plug-in PSHED função de retorno de chamada 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 Context membro 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 Header.RecordId membro 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.
Valor de retorno
Uma 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. |
Observações
Um plug-in PSHED que participa da persistência de registro de erro define o Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord membros da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para sua WriteErrorRecord, ReadErrorRecord e funções de retorno de chamada 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 de 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 de registro de erro, o PSHED chamará o plug-in PSHED ClearErrorRecord função de retorno de chamada para executar a operação de limpeza. O mecanismo usado para limpar o registro de erro do armazenamento de dados persistente do sistema é específico da plataforma.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ntddk.h (inclua Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |