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 |
|
| DLL |
|