Compartir a través de

Método IAmsiStream::GetAttribute (amsi.h)

  • Artículo

Devuelve un atributo solicitado de la secuencia.

Sintaxis

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

Parámetros

[in] attribute

Especifica el tipo de atributo que se va a devolver. Vea la sección Comentarios.

[in] dataSize

Tamaño del búfer de salida, los datos, en bytes.

[out] data

Búfer para recibir el atributo solicitado. los datos deben establecerse en su tamaño en bytes.

[out] retData

Número de bytes devueltos en los datos. Si este método devuelve E_NOT_SUFFICIENT_BUFFER, retData contiene el número de bytes necesarios.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_NOTIMPL
 No se admite el atributo .
E_NOT_SUFFICIENT_BUFFER
 El tamaño del búfer de salida, como se indica en los datos, no es lo suficientemente grande. retData contiene el número de bytes necesarios.
E_INVALIDARG
 Uno o varios argumentos no son válidos.
E_NOT_VALID_STATE
 El objeto no se inicializa.

Comentarios

Según el atributo solicitado en el atributo, se deben copiar los datos siguientes en los datos:

attribute data
AMSI_ATTRIBUTE_APP_NAME Nombre, versión o cadena GUID de la aplicación que llama, copiada de un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_NAME El nombre de archivo, la dirección URL, el identificador de script único o similar del contenido, copiado de un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_SIZE Tamaño de la entrada, como un ULONGLONG.
AMSI_ATTRIBUTE_CONTENT_ADDRESS Dirección de memoria si el contenido está totalmente cargado en la memoria.
AMSI_ATTRIBUTE_SESSION La sesión se usa para asociar diferentes llamadas de examen, como si el contenido que se va a examinar pertenece al mismo script original. Devuelve nullptr si el contenido es independiente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado amsi.h

Consulte también

AMSI_ATTRIBUTE

IAmsiStream