Compartir a través de


Función MpErrorMessageFormat

Devuelve un mensaje de error con formato basado en un código de error.

Sintaxis

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

Parámetros

hMpHandle [in]

Tipo: MPHANDLE

Controle la interfaz del administrador de protección contra malware. La función MpManagerOpen devuelve este identificador.

hrError [in]

Tipo: HRESULT

Código de error basado en HRESULT.

pwszErrorDesc [out]

Tipo: LPWSTR*

Devuelve un mensaje de error con formato basado en hrError. Esta cadena debe liberarse mediante MpFreeMemory.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en la función, el valor devuelto es un código HRESULT con error.

Comentarios

Esta función es capaz de dar formato a códigos de error del sistema además de códigos de error específicos devueltos por funciones de protección contra malware. Los códigos de error HRESULT específicos de las funciones de protección contra malware tienen una instalación de 0x50. A continuación se muestra una lista de un subconjunto de los códigos de error específicos de protección contra malware que pueden devolver varias funciones de protección contra malware. Con la macro HRESULT_FROM_MP_STATUS, los siguientes códigos de error se pueden convertir en HRESULT. Consulte también Códigos de error del motor antimalware de Forefront Client Security para obtener una lista de otros posibles códigos de error.

Código de error Descripción
ERROR_MP_NOENGINE No se carga ningún motor en el servicio antimalware para realizar la operación solicitada.
ERROR_MP_NO_MEMORY El motor de antimalware ha encontrado una situación de no memoria.
ERROR_MP_REMOVE_FAILED Error en la operación de eliminación de una amenaza específica.
ERROR_MP_QUARANTINE_FAILED Error en la operación de cuarentena para una amenaza específica.
ERROR_MP_THREAT_NOT_FOUND La amenaza específica ya no existe en el sistema.
ERROR_MP_REMOVE_NOT_SUPPORTED No se admite la operación de eliminación de una amenaza específica dentro del tipo de contenedor.
ERROR_MP_REMOVE_IMMUTABLE_CONTAINER Debido a la directiva del motor, no se admite una operación de eliminación de una amenaza específica dentro de un contenedor bloqueado. (Archivos de correo).
ERROR_MP_BADDB_OLDENGINE La solicitud de actualización de firma proporcionó un motor o archivos de firma antiguos.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado
MpClient.h
Archivo DLL
MpClient.dll

Consulte también

MpFreeMemory

MpManagerOpen

Códigos de error del motor antimalware de Forefront Client Security