IMAPIProp::GetLastError
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma estrutura MAPIERROR que contém informações sobre o erro anterior.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parâmetros
Hresult
[in] Um identificador para o código de erro gerado na chamada de método anterior.
ulFlags
[in] Um bitmask de sinalizadores que indica o formato do texto retornado na estrutura MAPIERROR apontada por lppMAPIError. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As cadeias de caracteres devem estar no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres deverão estar no formato ANSI.
lppMAPIError
[out] Um ponteiro para um ponteiro para a estrutura MAPIERROR que contém informações de versão, componente e contexto do erro. O parâmetro lppMAPIError poderá ser definido como NULL se não houver informações de erro a serem retornadas.
Valor de retorno
S_OK
As informações de erro foram retornadas.
MAPI_E_BAD_CHARWIDTH
O sinalizador MAPI_UNICODE foi definido e a implementação não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e a implementação dá suporte apenas ao Unicode.
Comentários
O método IMAPIProp::GetLastError fornece informações sobre uma chamada de método anterior que falhou. Os clientes podem fornecer aos seus usuários informações detalhadas sobre o erro, incluindo os dados da estrutura MAPIERROR em uma caixa de diálogo.
Todas as implementações do GetLastError fornecidas pelo MAPI são implementações ANSI, exceto para a implementação do IAddrBook . O método GetLastError incluído no IAddrBook dá suporte ao Unicode.
Observações para implementadores
Os detalhes da implementação desse método por um provedor de transporte remoto e quais mensagens esse método retorna cabem ao provedor de transporte, pois as condições de erro específicas que levam a vários valores HRESULT serão diferentes para diferentes provedores de transporte.
Notas para chamadores
Você pode usar a estrutura MAPIERROR apontada pelo parâmetro lppMAPIError , se GetLastError fornecer um, somente se o valor retornado for S_OK. Às vezes , GetLastError não pode determinar qual foi o último erro ou não tem mais nada a relatar sobre o erro. Nessa situação, um ponteiro para NULL é retornado em LppMAPIError .
Para liberar a memória da estrutura MAPIERROR , chame a função MAPIFreeBuffer .
Para obter mais informações sobre o método GetLastError , confira Erros Estendidos MAPI.