MpThreatQuery-Funktion

Wird verwendet, um statische Informationen (z. B. Schweregrad und Kategorie) oder lokalisierte Informationen (z. B. Kategoriebeschreibung und Empfehlungen) zu einer bestimmten Bedrohung abzufragen.

Syntax

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

Parameter

hMpHandle [ In]

Typ: MPHANDLE

Behandeln Sie die Schnittstelle des Schadsoftwareschutz-Managers. Dieses Handle wird von der MpManagerOpen-Funktion zurückgegeben.

ThreatID [ In]

Typ: _ MPTHREAT-ID

Bedrohungsbezeichner, für den Informationen angefordert werden.

ppThreatInfo [ out]

Typ: PMPTHREAT _ * INFO

Gibt einen Zeiger auf eine Bedrohungsinformationsstruktur zurück, MPTHREAT _ INFO. Die Struktur enthält Informationen wie Bedrohungs-ID, Name und Schweregrad.

ppThreatLocalizedInfo [ out, optional]

Typ: _ LOKALISIERTE PMPTHREAT-INFORMATIONEN _ *

Gibt einen Zeiger auf eine Struktur zurück, die lokalisierte Informationen über die Bedrohung enthält. Sie können NULL übergeben, wenn Sie nicht an lokalisierten Informationen zur Bedrohung interessiert sind. Weitere Informationen finden Sie _ unter LOKALISIERTE _ MPTHREAT-INFORMATIONEN.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert S _ OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein fehlerhafter HRESULT-Code. Der Aufrufer kann die MpErrorMessageFormat-Funktion verwenden, um eine generische Beschreibung der Fehlermeldung abzurufen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
[Windows 8 Nur Desktop-Apps]
Unterstützte Mindestversion (Server)
[Windows Server 2012 Nur Desktop-Apps]
Header
MpClient.h
DLL
MpClient.dll

Weitere Informationen

MpErrorMessageFormat

MpManagerÖffnen

_MPTHREAT-INFORMATIONEN

_LOKALISIERTE _ MPTHREAT-INFORMATIONEN