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 |
| 라이브러리 | Amsi.lib |
| DLL | Amsi.dll |