MpThreatEnumerate-Funktion

Gibt Informationen zur nächsten Bedrohung in der Enumerationsliste zurück. Diese Funktion kann wiederholt aufgerufen werden, bis die Enumeration aller Bedrohungen abgeschlossen ist.

Syntax

HRESULT WINAPI MpThreatEnumerate(
  _In_  MPHANDLE       hThreatEnumHandle,
  _Out_ PMPTHREAT_INFO *ppThreatInfo
);

Parameter

hThreatEnumHandle [in]

Typ: MPHANDLE

Handle für einen Bedrohungsenumerationskontext, der von MpThreatOpen zurückgegeben wird.

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.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn keine elemente mehr vorhanden sind, die zurückgegeben werden sollen, wird der Rückgabewert S_FALSE.

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.

Anforderungen

Siehe auch

MpErrorMessageFormat

MpThreatOpen

MPTHREAT_INFO