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

Метод IAmsiStream::GetAttribute (amsi.h)

  • Статья

Возвращает запрошенный атрибут из потока.

Синтаксис

HRESULT GetAttribute(
  [in]  AMSI_ATTRIBUTE attribute,
  [in]  ULONG          dataSize,
  [out] unsigned char  *data,
  [out] ULONG          *retData
);

Параметры

[in] attribute

Указывает тип возвращаемого атрибута. См. заметки.

[in] dataSize

Размер выходного буфера данных в байтах.

[out] data

Буфер для получения запрошенного атрибута. необходимо задать размер данных в байтах.

[out] retData

Количество байтов, возвращаемых в данных. Если этот метод возвращает E_NOT_SUFFICIENT_BUFFER, retData содержит необходимое количество байтов.

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

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

Код возврата Описание
S_OK
 Успешно.
E_NOTIMPL
 Атрибут не поддерживается.
E_NOT_SUFFICIENT_BUFFER
 Размер выходного буфера, как указано в данных, недостаточно велик. retData содержит необходимое количество байтов.
E_INVALIDARG
 Один или несколько аргументов недопустимы.
E_NOT_VALID_STATE
 Объект не инициализирован.

Комментарии

В зависимости от атрибута, запрошенного в атрибуте , в данные должны быть скопированы следующие данные:

атрибут data
AMSI_ATTRIBUTE_APP_NAME Имя, версия или строка GUID вызывающего приложения, скопированная из LPWSTR.
AMSI_ATTRIBUTE_CONTENT_NAME Имя файла, URL-адрес, уникальный идентификатор скрипта или аналогичное содержимое, скопированное из LPWSTR.
AMSI_ATTRIBUTE_CONTENT_SIZE Размер входных данных в виде ULONGLONG.
AMSI_ATTRIBUTE_CONTENT_ADDRESS Адрес памяти, если содержимое полностью загружено в память.
AMSI_ATTRIBUTE_SESSION Сеанс используется для связывания различных вызовов сканирования, например, если содержимое для проверки принадлежит одному и тому же исходному скрипту. Возвращает значение nullptr , если содержимое является автономным.

Требования

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

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

AMSI_ATTRIBUTE

IAmsiStream