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

Article
02/23/2024

Retourne un attribut demandé à partir du flux.

Syntaxe

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

Paramètres

[in] attribute

Spécifie le type d’attribut à retourner. Consultez la section Notes.

[in] dataSize

Taille de la mémoire tampon de sortie, données, en octets.

[out] data

Mémoire tampon pour recevoir l’attribut demandé. les données doivent être définies sur leur taille en octets.

[out] retData

Nombre d’octets retournés dans les données. Si cette méthode retourne E_NOT_SUFFICIENT_BUFFER, retData contient le nombre d’octets requis.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_NOTIMPL	L’attribut n’est pas pris en charge.
E_NOT_SUFFICIENT_BUFFER	La taille de la mémoire tampon de sortie, comme indiqué par les données, n’est pas assez grande. retData contient le nombre d’octets requis.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_NOT_VALID_STATE	L’objet n’est pas initialisé.

Remarques

Selon l’attribut demandé dans l’attribut, les données suivantes doivent être copiées dans les données :

attribute	data
AMSI_ATTRIBUTE_APP_NAME	Nom, version ou chaîne GUID de l’application appelante, copié à partir d’un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_NAME	Nom de fichier, URL, ID de script unique ou similaire du contenu, copié à partir d’un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_SIZE	Taille de l’entrée, en tant que ULONGLONG.
AMSI_ATTRIBUTE_CONTENT_ADDRESS	Adresse mémoire si le contenu est entièrement chargé en mémoire.
AMSI_ATTRIBUTE_SESSION	La session est utilisée pour associer différents appels d’analyse, par exemple si le contenu à analyser appartient au même script d’origine. Retourne nullptr si le contenu est autonome.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	amsi.h

Voir aussi

AMSI_ATTRIBUTE

IAmsiStream

Partager via