共用方式為

IAmsiStream：：GetAttribute 方法 (amsi.h)

  • 發行項

從數據流傳回要求的屬性。

語法

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 從 LPWSTR 複製之呼叫應用程式的名稱、版本或 GUID 字串。
AMSI_ATTRIBUTE_CONTENT_NAME 從 LPWSTR 複製的檔名、URL、唯一腳本標識碼或類似的內容。
AMSI_ATTRIBUTE_CONTENT_SIZE 輸入的大小，以 ULONGLONG 表示。
AMSI_ATTRIBUTE_CONTENT_ADDRESS 如果內容完全載入記憶體中，則為記憶體位址。
AMSI_ATTRIBUTE_SESSION 會話是用來建立不同掃描呼叫的關聯，例如，要掃描的內容是否屬於相同的原始腳本。 如果內容為獨立式，則傳回 nullptr 。

規格需求

需求 值
最低支援的用戶端 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 amsi.h

另請參閱

AMSI_ATTRIBUTE

IAmsiStream