MpErrorMessageFormat-Funktion

Gibt eine formatierte Fehlermeldung basierend auf einem Fehlercode zurück.

Syntax

HRESULT WINAPI MpErrorMessageFormat(
  _In_  MPHANDLE hMpHandle,
  _In_  HRESULT  hrError,
  _Out_ LPWSTR   *pwszErrorDesc
);

Parameter

hMpHandle [ In]

Typ: MPHANDLE

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

hrError [ In]

Typ: HRESULT

Ein HRESULT-basierter Fehlercode.

pwszErrorDesc [ out]

Typ: LPWSTR *

Gibt eine formatierte Fehlermeldung basierend auf hrError zurück. Diese Zeichenfolge muss mit mpFreeMemoryfreigegeben werden.

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.

Hinweise

Diese Funktion kann Systemfehlercodes zusätzlich zu bestimmten Fehlercodes formatieren, die von Funktionen zum Schutz vor Schadsoftware zurückgegeben werden. Die HRESULT-Fehlercodes, die für Schadsoftwareschutzfunktionen spezifisch sind, verfügen über 0x50. Im Folgenden finden Sie eine Liste mit einer Teilmenge der spezifischen Fehlercodes für den Schadsoftwareschutz, die von verschiedenen Funktionen zum Schutz vor Schadsoftware zurückgegeben werden können. Mithilfe des Makros HRESULT _ FROM MP _ _ STATUS können die folgenden Fehlercodes in HRESULT konvertiert werden. Eine Liste anderer möglicher Fehlercodes finden Sie unter Fehlercodes der Antischadsoftware-Engine für Forefront Client Security.

Fehlercode BESCHREIBUNG
FEHLER _ MP _ NOENGINE Es wird keine Engine in den Antischadsoftwaredienst geladen, um den angeforderten Vorgang auszuführen.
FEHLER _ MP _ KEIN _ ARBEITSSPEICHER Bei der Antischadsoftware-Engine ist eine Situation ohne Arbeitsspeicher aufgetreten.
FEHLER _ MP _ REMOVE _ FAILED Fehler beim Entfernen des Vorgangs für eine bestimmte Bedrohung.
FEHLER _ _ BEI MP-QUARANTÄNEFEHLER _ Fehler beim Quarantänevorgang für eine bestimmte Bedrohung.
FEHLER _ _ MP-BEDROHUNG _ NICHT _ GEFUNDEN Die spezifische Bedrohung ist im System nicht mehr vorhanden.
FEHLER _ MP REMOVE NICHT _ _ _ UNTERSTÜTZT Der Entfernungsvorgang für eine bestimmte Bedrohung innerhalb des Containertyps wird nicht unterstützt.
FEHLER _ MP _ REMOVE _ IMMUTABLE _ CONTAINER Aufgrund der Engine-Richtlinie wird ein Entfernungsvorgang einer bestimmten Bedrohung innerhalb eines blockierten Containers nicht unterstützt. (E-Mail-Archive.)
FEHLER _ MP _ BADDB _ OLDENGINE Die Signaturupdateanforderung hat eine ältere Engine oder Signaturdateien bereitgestellt.

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

MpFreeMemory

MpManagerOpen

Fehlercodes der Antischadsoftware-Engine für Forefront Client Security