Função AmsiScanString (amsi.h)

Examina uma cadeia de caracteres em busca de malware.

Sintaxe

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

Parâmetros

[in] amsiContext

O identificador do tipo HAMSICONTEXT que foi recebido inicialmente de AmsiInitialize.

[in] string

A cadeia de caracteres a ser examinada.

[in] contentName

O nome do arquivo, a URL, a ID de script exclusiva ou semelhante ao conteúdo que está sendo verificado.

[in, optional] amsiSession

Se várias solicitações de verificação devem ser correlacionadas em uma sessão, defina a sessão como o identificador do tipo HAMSISESSION que foi recebido inicialmente de AmsiOpenSession. Caso contrário, defina a sessão como nullptr.

[out] result

O resultado da verificação. Consulte AMSI_RESULT.

Um aplicativo deve usar AmsiResultIsMalware para determinar se o conteúdo deve ser bloqueado.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	amsi.h
Biblioteca	Amsi.lib
DLL	Amsi.dll