функция обратного вызова PSHED_PI_CLEAR_ERROR_RECORD (ntddk.h)

Функция обратного вызова PSHED ClearErrorRecord очищает указанную запись об ошибке из постоянного хранилища данных системы.

Синтаксис

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

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

Параметры

[in, out, optional] PluginContext

Указатель на область контекста, указанную в контексте член структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET, когда подключаемый модуль PSHED вызывает функцию PshedRegisterPlugin для регистрации в PSHED.

[in] Flags

Битовая комбинация флагов OR, влияющих на четкую операцию. В настоящее время флаги не определены.

[in] ErrorRecordId

Идентификатор записи об ошибке, очищаемой из постоянного хранилища данных системы. Этот идентификатор следует сравнить с элементом Header.RecordId каждой WHEA_ERROR_RECORD структуры, записанной в постоянное хранилище данных системы, чтобы определить запись ошибки, которую необходимо очистить.

Возвращаемое значение

Функция обратного вызова PSHED ClearErrorRecor d возвращает один из следующих кодов NTSTATUS:

Возвращаемый код Описание
STATUS_SUCCESS Запись об ошибке была успешно удалена из постоянного хранилища данных системы.
STATUS_UNSUCCESSFUL Произошла ошибка.

Замечания

Подключаемый модуль PSHED, который участвует в сохраняемости записи ошибок, задает callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord и Callbacks.ClearErrorRecord члены структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET, чтобы указать на ее WriteErrorRecord, ReadErrorRecordи Функции обратного вызова ClearErrorRecord при вызове функции обратного вызова PshedRegisterPlu gin для регистрации в PSHED. Подключаемый модуль PSHED также должен задать флаг PshedFAErrorRecordPersistence в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Ядро Windows вызывает PSHED для очистки записи об ошибке из постоянного хранилища данных системы. Если подключаемый модуль PSHED зарегистрирован для участия в сохраняемости записей ошибок, PSHED вызывает функцию обратного вызова модуля PSHED ClearErrorRecord обратного вызова. Механизм, используемый для очистки записи об ошибке из постоянного хранилища данных системы, зависит от платформы.

Требования

Требование Ценность
целевая платформа Настольный
заголовка ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

См. также

PshedRegisterPlugin

ReadErrorRecord

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET

WriteErrorRecord