Función MpThreatQuery

Se usa para consultar información estática (como gravedad y categoría) o localizada (por ejemplo, descripción de categoría y consejos) sobre una amenaza determinada.

Sintaxis

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 de la interfaz del administrador de protección contra malware. La función MpManagerOpen devuelve este identificador.

ThreatID [in]

Tipo: MPTHREAT_ID

Identificador de amenaza para el que se solicita información.

ppThreatInfo [out]

Tipo: PMPTHREAT_INFO*

Devuelve un puntero a una estructura de información de amenazas, MPTHREAT_INFO. La estructura contiene información como el identificador de amenaza, el nombre y la gravedad.

ppThreatLocalizedInfo [out, optional]

Tipo: PMPTHREAT_LOCALIZED_INFO*

Devuelve un puntero a una estructura que contiene información localizada sobre la amenaza. Puede pasar NULL si no está interesado en la información localizada sobre la amenaza. Consulte MPTHREAT_LOCALIZED_INFO.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en la función, el valor devuelto es un código HRESULT con error. El llamador puede usar la función MpErrorMessageFormat para obtener una descripción genérica del mensaje de error.

Requisitos

Vea también

MpErrorMessageFormat

MpManagerOpen

MPTHREAT_INFO

MPTHREAT_LOCALIZED_INFO