MpErrorMessageFormat-Funktion

Artikel
06/13/2023

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 Malware-Schutz-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 mithilfe von MpFreeMemory freigegeben werden.

Rückgabewert

Typ: HRESULT

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein fehlerhafter HRESULT-Code .

Bemerkungen

Diese Funktion ist in der Lage, Systemfehlercodes zusätzlich zu bestimmten Fehlercodes zu formatieren, die von Schadsoftwareschutzfunktionen zurückgegeben werden. Die für Schadsoftwareschutzfunktionen spezifischen HRESULT-Fehlercodes verfügen über eine Möglichkeit von 0x50. Im Folgenden finden Sie eine Liste einer Teilmenge der spezifischen Fehlercodes für den Schadsoftwareschutz, die von verschiedenen Funktionen zum Schutz vor Schadsoftware zurückgegeben werden können. Mithilfe der Makro-HRESULT_FROM_MP_STATUS können die folgenden Fehlercodes in HRESULT konvertiert werden. Eine Liste anderer möglicher Fehlercodes finden Sie unter Fehlercodes der Forefront Client Security-Anti-Malware-Engine .

Fehlercode	BESCHREIBUNG
ERROR_MP_NOENGINE	Es wird kein Modul in den Antischadsoftwaredienst geladen, um den angeforderten Vorgang auszuführen.
ERROR_MP_NO_MEMORY	Die Antischadsoftware-Engine hat eine Situation ohne Arbeitsspeicher festgestellt.
ERROR_MP_REMOVE_FAILED	Fehler beim Entfernen des Vorgangs für eine bestimmte Bedrohung.
ERROR_MP_QUARANTINE_FAILED	Fehler beim Quarantänevorgang für eine bestimmte Bedrohung.
ERROR_MP_THREAT_NOT_FOUND	Die spezifische Bedrohung ist nicht mehr im System vorhanden.
ERROR_MP_REMOVE_NOT_SUPPORTED	Der Entfernenvorgang für eine bestimmte Bedrohung innerhalb des Containertyps wird nicht unterstützt.
ERROR_MP_REMOVE_IMMUTABLE_CONTAINER	Aufgrund der Engine-Richtlinie wird ein Entfernungsvorgang einer bestimmten Bedrohung in einem blockierten Container nicht unterstützt. (Mailarchive.)
ERROR_MP_BADDB_OLDENGINE	Die Signaturaktualisierungsanforderung 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

Siehe auch

MpFreeMemory
MpManagerOpen
Fehlercodes der Forefront Client Security-Antischadsoftware-Engine

Freigeben über