Metodo IAmsiStream::GetAttribute (amsi.h)

  • Articolo

Restituisce un attributo richiesto dal flusso.

Sintassi

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

Parametri

[in] attribute

Specifica il tipo di attributo da restituire. Vedere la sezione Osservazioni.

[in] dataSize

Dimensioni del buffer di output, dei dati, in byte.

[out] data

Buffer per ricevere l'attributo richiesto. i dati devono essere impostati sulla dimensione in byte.

[out] retData

Numero di byte restituiti nei dati. Se questo metodo restituisce E_NOT_SUFFICIENT_BUFFER, retData contiene il numero di byte necessari.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_NOTIMPL
 L'attributo non è supportato.
E_NOT_SUFFICIENT_BUFFER
 Le dimensioni del buffer di output, come indicato dai dati, non sono sufficienti. retData contiene il numero di byte necessari.
E_INVALIDARG
 Uno o più argomenti non sono validi.
E_NOT_VALID_STATE
 L'oggetto non viene inizializzato.

Commenti

A seconda dell'attributo richiesto nell'attributo, i dati seguenti devono essere copiati nei dati:

Attributo data
AMSI_ATTRIBUTE_APP_NAME Stringa nome, versione o GUID dell'applicazione chiamante copiata da un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_NAME Nome file, URL, ID script univoco o simile del contenuto copiato da un LPWSTR.
AMSI_ATTRIBUTE_CONTENT_SIZE Dimensioni dell'input, come ULONGLONG.
AMSI_ATTRIBUTE_CONTENT_ADDRESS Indirizzo di memoria se il contenuto è completamente caricato in memoria.
AMSI_ATTRIBUTE_SESSION La sessione viene usata per associare diverse chiamate di analisi, ad esempio se il contenuto da analizzare appartiene allo stesso script originale. Restituisce nullptr se il contenuto è autonomo.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione amsi.h

Vedi anche

AMSI_ATTRIBUTE

IAmsiStream