Функция AmsiScanString (amsi.h)

Статья
08/22/2023

Проверяет строку на наличие вредоносных программ.

Синтаксис

HRESULT AmsiScanString(
  [in]           HAMSICONTEXT amsiContext,
  [in]           LPCWSTR      string,
  [in]           LPCWSTR      contentName,
  [in, optional] HAMSISESSION amsiSession,
  [out]          AMSI_RESULT  *result
);

Параметры

[in] amsiContext

Дескриптор типа HAMSICONTEXT, изначально полученный от AmsiInitialize.

[in] string

Строка для проверки.

[in] contentName

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

[in, optional] amsiSession

Если несколько запросов на сканирование должны быть сопоставлены в рамках сеанса, задайте для сеанса дескриптор типа HAMSISESSION, который был первоначально получен из AmsiOpenSession. В противном случае задайте для сеанса значение nullptr.

[out] result

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

Приложение должно использовать AmsiResultIsMalware , чтобы определить, следует ли блокировать содержимое.

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	amsi.h
Библиотека	Amsi.lib
DLL	Amsi.dll

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

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