IMAPITable::GetLastError
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma estrutura MAPIERROR que contém informações sobre o erro anterior na tabela.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parâmetros
Hresult
[in] HRESULT que contém o erro gerado na chamada de método anterior.
ulFlags
[in] Bitmask de sinalizadores que controla o tipo das cadeias de caracteres retornadas. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As cadeias de caracteres na estrutura MAPIERROR retornadas no parâmetro lppMAPIError estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.
lppMAPIError
[out] Ponteiro para um ponteiro para a estrutura MAPIERROR retornada que contém informações de versão, componente e contexto do erro. O parâmetro lppMAPIError pode ser definido como NULL se uma estrutura MAPIERROR com informações apropriadas não puder ser fornecida.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
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 IMAPITable::GetLastError retorna informações detalhadas, se disponíveis, sobre uma chamada de método anterior que falhou. Essas informações podem ser exibidas em uma mensagem ou em uma caixa de diálogo.
Notas para chamadores
Chame GetLastError sempre que precisar exibir informações sobre um erro para o usuário.
Você pode usar a estrutura MAPIERROR apontada pelo parâmetro lppMAPIError se o objeto de tabela fornecer um somente se GetLastError retornar S_OK. Às vezes, a implementação da tabela não pode determinar qual foi o último erro ou não tem mais nada a relatar sobre o erro. Nessa situação, o ponteiro em lppMAPIError é definido como NULL.
Para liberar toda a memória alocada para a estrutura MAPIERROR , chame a função MAPIFreeBuffer .
Para obter mais informações sobre o método GetLastError , confira Erros Estendidos MAPI.