Função MpErrorMessageFormat
Retorna uma mensagem de erro formatada com base em um código de erro.
Sintaxe
HRESULT WINAPI MpErrorMessageFormat(
_In_ MPHANDLE hMpHandle,
_In_ HRESULT hrError,
_Out_ LPWSTR *pwszErrorDesc
);
Parâmetros
-
hMpHandle [in]
-
Tipo: MPHANDLE
Identificador para a interface do gerenciador de proteção contra malware. Esse identificador é retornado pela função MpManagerOpen .
-
hrError [in]
-
Tipo: HRESULT
Um código de erro baseado em HRESULT.
-
pwszErrorDesc [out]
-
Tipo: LPWSTR*
Retorna uma mensagem de erro formatada com base em hrError. Essa cadeia de caracteres deve ser liberada usando MpFreeMemory.
Valor retornado
Tipo: HRESULT
Se a função tiver êxito, o valor retornado será S_OK.
Se a função falhar, o valor retornado será um código HRESULT com falha.
Comentários
Essa função é capaz de formatar códigos de erro do sistema, além de códigos de erro específicos retornados por funções de proteção contra malware. Os códigos de erro HRESULT específicos para funções de proteção contra malware têm uma facilidade de 0x50. Abaixo está uma lista de um subconjunto dos códigos de erro específicos da proteção contra malware que podem ser retornados por várias funções de proteção contra malware. Usando a macro HRESULT_FROM_MP_STATUS, os seguintes códigos de erro podem ser convertidos em HRESULT. Consulte também Códigos de erro do mecanismo antimalware do Forefront Client Security para obter uma lista de outros códigos de erro possíveis.
| Código do Erro | Descrição |
|---|---|
| ERROR_MP_NOENGINE | Nenhum mecanismo é carregado no serviço antimalware para executar a operação solicitada. |
| ERROR_MP_NO_MEMORY | O mecanismo antimalware encontrou uma situação sem memória. |
| ERROR_MP_REMOVE_FAILED | Falha na operação de remoção de uma ameaça específica. |
| ERROR_MP_QUARANTINE_FAILED | Falha na operação de quarentena para uma ameaça específica. |
| ERROR_MP_THREAT_NOT_FOUND | A ameaça específica não existe mais no sistema. |
| ERROR_MP_REMOVE_NOT_SUPPORTED | Não há suporte para a operação de remoção de uma ameaça específica dentro do tipo de contêiner. |
| ERROR_MP_REMOVE_IMMUTABLE_CONTAINER | Devido à política de mecanismo, não há suporte para uma operação de remoção de uma ameaça específica dentro de um contêiner bloqueado. (Arquivos de email.) |
| ERROR_MP_BADDB_OLDENGINE | A solicitação de atualização de assinatura forneceu um mecanismo ou arquivos de assinatura mais antigos. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|