AmsiScanString 関数 (amsi.h)

文字列でマルウェアをスキャンします。

構文

HRESULT AmsiScanString(
  [in]           HAMSICONTEXT amsiContext,
  [in]           LPCWSTR      string,
  [in]           LPCWSTR      contentName,
  [in, optional] HAMSISESSION amsiSession,
  [out]          AMSI_RESULT  *result
);

パラメーター

[in] amsiContext

AmsiInitialize から最初に受信した HAMSICONTEXT 型のハンドル。

[in] string

スキャンする文字列。

[in] contentName

スキャンされるコンテンツのファイル名、URL、一意のスクリプト ID、または類似した内容。

[in, optional] amsiSession

セッション内で複数のスキャン要求を関連付ける場合は、AmsiOpenSession から最初に受信した型 HAMSISESSION のハンドルにセッションを設定します。 それ以外の場合は、 セッション を nullptr に設定します。

[out] result

スキャンの結果。 「AMSI_RESULT」を参照してください。

アプリでは 、AmsiResultIsMalware を使用して、コンテンツをブロックする必要があるかどうかを判断する必要があります。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

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

こちらもご覧ください

AMSI_RESULT

AmsiInitialize

AmsiOpenSession

AmsiResultIsMalware