Метод IAntimalware2::Notify (amsi.h)

Статья
08/22/2023

Отправляет в продукт защиты от вредоносных программ уведомление о произвольной операции. Уведомление не подразумевает запрос антивирусной проверки. Скорее, IAntimalware2::Notify предназначен для предоставления быстрого и легкого механизма для информирования антивредоносного продукта о том, что произошло событие. Как правило, антивредоносный продукт должен обработать уведомление и как можно быстрее вернуться к вызывающей программе.

Синтаксис

HRESULT Notify(
  PVOID       buffer,
  ULONG       length,
  LPCWSTR     contentName,
  LPCWSTR     appName,
  AMSI_RESULT *pResult
);

Параметры

buffer

Тип: PVOID

Буфер, содержащий данные уведомления.

length

Тип: ULONG

Длина (в байтах) данных, считываемых из буфера.

contentName

Тип: LPCWSTR

Имя файла, URL-адрес, уникальный идентификатор скрипта или аналогичное сканируемое содержимое.

appName

Тип: LPCWSTR

Имя приложения, отправляющего уведомление AMSI.

pResult

Тип: AMSI_RESULT*

Результат сканирования.

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

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Один или несколько аргументов недопустимы.
E_NOT_VALID_STATE	Объект не инициализирован.

Требования


Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	amsi.h

См. также раздел

Интерфейс IAntimalware2

Поделиться через