MpErrorMessageFormat 函式
根據錯誤碼傳回格式化的錯誤訊息。
語法
HRESULT WINAPI MpErrorMessageFormat(
_In_ MPHANDLE hMpHandle,
_In_ HRESULT hrError,
_Out_ LPWSTR *pwszErrorDesc
);
參數
-
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 | 由於引擎原則，不支援在封鎖容器內移除特定威脅的作業。 (郵件封存。) |
| ERROR_MP_BADDB_OLDENGINE | 簽章更新要求 () 提供較舊的引擎或簽章檔案。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|