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
 1 つ以上の引数が無効です。
E_NOT_VALID_STATE
 オブジェクトが初期化されていません。

注釈

属性で要求された属性に応じて、次のデータをデータにコピーする必要があります。

attribute data
AMSI_ATTRIBUTE_APP_NAME LPWSTR からコピーされた呼び出し元アプリケーションの名前、バージョン、または GUID 文字列。
AMSI_ATTRIBUTE_CONTENT_NAME LPWSTR からコピーされたファイル名、URL、一意のスクリプト ID、または同様のコンテンツ。
AMSI_ATTRIBUTE_CONTENT_SIZE ULONGLONG としての入力のサイズ。
AMSI_ATTRIBUTE_CONTENT_ADDRESS コンテンツがメモリに完全に読み込まれている場合のメモリ アドレス。
AMSI_ATTRIBUTE_SESSION セッションは、スキャンする内容が同じ元のスクリプトに属している場合など、さまざまなスキャン呼び出しを関連付けるために使用されます。 コンテンツが自己完結型の場合は nullptr を返します。

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー amsi.h

こちらもご覧ください

AMSI_ATTRIBUTE

IAmsiStream