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、唯一腳本標識碼或類似內容。
[in, optional] amsiSession
如果要在會話內相互關聯多個掃描要求,請將 會話 設定為一開始從 AmsiOpenSession收到的HAMSISESSION類型句柄。 否則,請將 會話 設定為 nullptr。
[out] result
掃描的結果。 請參閱 AMSI_RESULT。
應用程式應該使用 AmsiResultIsMalware 來判斷是否應封鎖內容。
傳回值
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | amsi.h |
程式庫 | Amsi.lib |
Dll | Amsi.dll |