AmsiScanBuffer 함수(amsi.h)

버퍼가 가득 찬 콘텐츠에서 맬웨어를 검사합니다.

구문

HRESULT AmsiScanBuffer(
  [in]           HAMSICONTEXT amsiContext,
  [in]           PVOID        buffer,
  [in]           ULONG        length,
  [in]           LPCWSTR      contentName,
  [in, optional] HAMSISESSION amsiSession,
  [out]          AMSI_RESULT  *result
);

매개 변수

[in] amsiContext

AmsiInitialize에서 처음 받은 HAMSICONTEXT 형식의 핸들입니다.

[in] buffer

검사할 데이터를 읽을 버퍼입니다.

[in] length

버퍼에서 읽을 데이터의 길이(바이트)입니다.

[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

추가 정보

AMSI_RESULT

AmsiInitialize

AmsiOpenSession

AmsiResultIsMalware