IMSLogon::GetLastError
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma estrutura MAPIERROR que contém informações sobre o último erro ocorrido para o objeto do repositório de mensagens.
HRESULT GetLastError(
HRESULT hResult,
ULONG ulFlags,
LPMAPIERROR FAR * lppMAPIError
);
Parâmetros
Hresult
[in] Um tipo de dados HRESULT que contém o valor de erro gerado na chamada de método anterior para o objeto do repositório de mensagens.
ulFlags
[in] Um bitmask de sinalizadores que controla o tipo de 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] Um 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 poderá ser definido como NULL se não houver MAPIERROR para retornar.
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
Use o método IMSLogon::GetLastError para recuperar informações a serem exibidas em uma mensagem ao usuário sobre o último erro retornado de uma chamada de método para o objeto do repositório de mensagens.
Para liberar toda a memória alocada pelo MAPI para a estrutura MAPIERROR retornada, os aplicativos cliente precisam chamar apenas a função MAPIFreeBuffer .
O valor retornado do GetLastError deve ser S_OK para um aplicativo usar o MAPIERROR. Mesmo que o valor retornado seja S_OK, um MAPIERROR pode não ser retornado. Se a implementação não puder determinar qual foi o último erro ou se um MAPIERROR não estiver disponível para esse erro, GetLastError retornará um ponteiro para NULL em lppMAPIError .