MAPIERROR
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona información detallada sobre un error, generado normalmente por el sistema operativo, MAPI o un proveedor de servicios.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
typedef struct _MAPIERROR
{
ULONG ulVersion;
LPSTR lpszError;
LPSTR lpszComponent;
ULONG ulLowLevelError;
ULONG ulContext;
} MAPIERROR, FAR * LPMAPIERROR;
Members
ulVersion
Número de versión de la estructura. El miembro ulVersion se usa para la expansión futura y debe establecerse en MAPI_ERROR_VERSION, que actualmente se define como cero.
lpszError
Puntero a una cadena que describe el error. Esta cadena estará en formato Unicode si el parámetro ulFlags en el método en el que se usa esta estructura se establece en MAPI_UNICODE.
lpszComponent
Puntero a una cadena que describe el componente que generó el error. Esta cadena estará en formato Unicode si el parámetro ulFlags en el método en el que se usa esta estructura se establece en MAPI_UNICODE.
ulLowLevelError
Valor de error de bajo nivel que solo se usa cuando el error que se va a devolver es de bajo nivel.
ulContext
Valor que representa la ubicación en el componente al que apunta el miembro lpszComponent que identifica dónde se produjo el error.
Comentarios
La estructura MAPIERROR se usa para describir la información de error. Los clientes y proveedores de servicios pasan un puntero a una estructura MAPIERROR en el parámetro lppMAPIError del método IMAPIProp::GetLastError . GetLastError devuelve información sobre el error anterior que se ha producido en un objeto . Los autores de llamadas de GetLastError liberan la memoria de la estructura MAPIERROR llamando a MAPIFreeBuffer.
El miembro lpszComponent se puede usar para asignar el archivo de Ayuda del componente, si existe uno. Los proveedores de servicios deben limitar el tamaño de la cadena de componente a 30 caracteres para que se pueda mostrar fácilmente en un cuadro de diálogo. El miembro ulContext también se puede usar para hacer referencia a un tema de ayuda en línea para ver errores comunes.
Dado que no es necesario que los proveedores de servicios proporcionen información de error detallada, los clientes no deben esperar que ninguno de los miembros de la estructura MAPIERROR que se devuelven contengan datos válidos. Sin embargo, como mínimo MAPI recomienda encarecidamente que los proveedores especifiquen información en los miembros lpszComponent y ulContext .
Para obtener más información sobre el control de errores en MAPI, vea Control de errores.