IMAPIProp::GetLastError
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una estructura MAPIERROR que contiene información sobre el error anterior.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parameters
Hresult
[in] Identificador del código de error generado en la llamada al método anterior.
ulFlags
[in] Máscara de bits de marcas que indica el formato del texto devuelto en la estructura MAPIERROR a la que apunta lppMAPIError. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las cadenas deben estar en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas deben estar en formato ANSI.
lppMAPIError
[out] Puntero a un puntero a la estructura MAPIERROR que contiene información de versión, componente y contexto del error. El parámetro lppMAPIError se puede establecer en NULL si no hay información de error que devolver.
Valor devuelto
S_OK
Se devolvió la información de error.
MAPI_E_BAD_CHARWIDTH
Se estableció la marca de MAPI_UNICODE y la implementación no admite Unicode, o MAPI_UNICODE no se estableció y la implementación solo admite Unicode.
Comentarios
El método IMAPIProp::GetLastError proporciona información sobre una llamada al método anterior que produjo un error. Los clientes pueden proporcionar a sus usuarios información detallada sobre el error incluyendo los datos de la estructura MAPIERROR en un cuadro de diálogo.
Todas las implementaciones de GetLastError proporcionadas por MAPI son implementaciones ANSI, excepto la implementación de IAddrBook . El método GetLastError incluido con IAddrBook admite Unicode.
Notas a los implementadores
Los detalles de la implementación de este método por parte de un proveedor de transporte remoto y los mensajes que devuelve este método dependen del proveedor de transporte, ya que las condiciones de error concretas que conducen a varios valores HRESULT serán diferentes para los distintos proveedores de transporte.
Notas para los llamadores
Puede usar la estructura MAPIERROR a la que apunta el parámetro lppMAPIError , si GetLastError proporciona uno, solo si se S_OK el valor devuelto. A veces , GetLastError no puede determinar cuál fue el último error o no tiene nada más que informar sobre el error. En esta situación, se devuelve un puntero a NULL en lppMAPIError en su lugar.
Para liberar la memoria de la estructura MAPIERROR , llame a la función MAPIFreeBuffer .
Para obtener más información sobre el método GetLastError , vea Errores extendidos mapi.