Compartilhar via


Função MpThreatQuery

Usado para consultar informações estáticas (como gravidade e categoria) ou localizadas (como descrição da categoria e conselhos) sobre uma ameaça específica.

Sintaxe

HRESULT WINAPI MpThreatQuery(
  _In_      MPHANDLE                 hMpHandle,
  _In_      MPTHREAT_ID              ThreatID,
  _Out_     PMPTHREAT_INFO           *ppThreatInfo,
  _Out_opt_ PMPTHREAT_LOCALIZED_INFO *ppThreatLocalizedInfo
);

Parâmetros

hMpHandle [in]

Tipo: MPHANDLE

Identificador para a interface do gerenciador de proteção contra malware. Esse identificador é retornado pela função MpManagerOpen .

ThreatID [in]

Tipo: MPTHREAT_ID

Identificador de ameaça para o qual as informações são solicitadas.

ppThreatInfo [out]

Tipo: PMPTHREAT_INFO*

Retorna um ponteiro para uma estrutura de informações de ameaça , MPTHREAT_INFO. A estrutura contém informações como id de ameaça, nome e gravidade.

ppThreatLocalizedInfo [out, optional]

Tipo: PMPTHREAT_LOCALIZED_INFO*

Retorna um ponteiro para uma estrutura que contém informações localizadas sobre a ameaça. Você poderá passar NULL se não estiver interessado em informações localizadas sobre a ameaça. Confira MPTHREAT_LOCALIZED_INFO.

Valor retornado

Tipo: HRESULT

Se a função tiver êxito, o valor retornado será S_OK.

Se a função falhar, o valor retornado será um código HRESULT com falha. O chamador pode usar a função MpErrorMessageFormat para obter uma descrição genérica da mensagem de erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho
MpClient.h
DLL
MpClient.dll

Confira também

MpErrorMessageFormat

MpManagerOpen

MPTHREAT_INFO

MPTHREAT_LOCALIZED_INFO