Функция 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 |
|