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

Статья
08/22/2023

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

Синтаксис

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

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