IAmsiStream::GetAttribute-Methode (amsi.h)

Artikel
08/22/2023

Gibt ein angefordertes Attribut aus dem Stream zurück.

Syntax

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

Parameter

[in] attribute

Gibt den Typ des zurückzugebenden Attributs an. Siehe Hinweise.

[in] dataSize

Die Größe des Ausgabepuffers ( Daten) in Bytes.

[out] data

Puffer, um das angeforderte Attribut zu empfangen. Daten müssen auf ihre Größe in Bytes festgelegt werden.

[out] retData

Die Anzahl der in Daten zurückgegebenen Bytes. Wenn diese Methode E_NOT_SUFFICIENT_BUFFER zurückgibt, enthält retData die anzahl der erforderlichen Bytes.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_NOTIMPL	Das Attribut wird nicht unterstützt.
E_NOT_SUFFICIENT_BUFFER	Die Größe des Ausgabepuffers ist, wie durch Daten angegeben, nicht groß genug. retData enthält die Anzahl der erforderlichen Bytes.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_NOT_VALID_STATE	Das Objekt wird nicht initialisiert.

Hinweise

Je nach dem im Attribut angeforderten Attribut sollten die folgenden Daten in Daten kopiert werden:

attribute	data
AMSI_ATTRIBUTE_APP_NAME	Der Name, die Version oder die GUID-Zeichenfolge der aufrufenden Anwendung, die aus einem LPWSTR kopiert wurde.
AMSI_ATTRIBUTE_CONTENT_NAME	Der Dateiname, die URL, die eindeutige Skript-ID oder ähnliches des Inhalts, die aus einem LPWSTR kopiert wurden.
AMSI_ATTRIBUTE_CONTENT_SIZE	Die Größe der Eingabe als ULONGLONGLONG.
AMSI_ATTRIBUTE_CONTENT_ADDRESS	Die Speicheradresse, wenn der Inhalt vollständig in den Arbeitsspeicher geladen ist.
AMSI_ATTRIBUTE_SESSION	Die Sitzung wird verwendet, um verschiedene Scanaufrufe zuzuordnen, z. B. wenn der zu scannende Inhalt demselben ursprünglichen Skript angehört. Gibt NULLptr zurück , wenn der Inhalt eigenständig ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	amsi.h

Weitere Informationen

AMSI_ATTRIBUTE

IAmsiStream

Freigeben über