MpErrorMessageFormat 函数

返回基于错误代码的格式化错误消息。

语法

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

parameters

hMpHandle [in]

类型： MPHANDLE

恶意软件保护管理器接口的句柄。 此句柄由 MpManagerOpen 函数返回。

hrError [in]

类型： HRESULT

基于 HRESULT 的错误代码。

pwszErrorDesc [out]

类型： LPWSTR*

返回基于 hrError 的格式化错误消息。 必须使用 MpFreeMemory 释放此字符串。

返回值

类型： HRESULT

如果函数成功，则返回值为 S_OK。

如果函数失败，则返回值是失败的 HRESULT 代码。

备注

除了恶意软件保护函数返回的特定错误代码外，此函数还能够格式化系统错误代码。 特定于恶意软件保护功能的 HRESULT 错误代码具有0x50功能。 下面是可由各种恶意软件保护功能返回的恶意软件保护特定错误代码子集的列表。 使用宏 HRESULT_FROM_MP_STATUS，可将以下错误代码转换为 HRESULT。 另请参阅 Forefront Client Security 反恶意软件引擎错误代码 ，了解其他可能的错误代码列表。

错误代码	说明
ERROR_MP_NOENGINE	不会在反恶意软件服务中加载任何引擎来执行请求的操作。
ERROR_MP_NO_MEMORY	反恶意软件引擎遇到无内存的情况。
ERROR_MP_REMOVE_FAILED	针对特定威胁的删除操作失败。
ERROR_MP_QUARANTINE_FAILED	针对特定威胁的隔离操作失败。
ERROR_MP_THREAT_NOT_FOUND	系统中不再存在特定威胁。
ERROR_MP_REMOVE_NOT_SUPPORTED	不支持对容器类型中的特定威胁执行删除操作。
ERROR_MP_REMOVE_IMMUTABLE_CONTAINER	由于引擎策略，不支持在阻止的容器内执行特定威胁的删除操作。 (Mail archives.)
ERROR_MP_BADDB_OLDENGINE	签名更新请求提供了较旧的引擎或签名文件 () 。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
标头	MpClient.h
DLL	MpClient.dll

另请参阅

MpFreeMemory

MpManagerOpen

Forefront 客户端安全反恶意软件引擎错误代码