Compartilhar via

IMAPISupport::GetLastError

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Retorna uma estrutura MAPIERROR que contém informações sobre o erro do objeto de suporte anterior.

HRESULT GetLastError(
  HRESULT hResult,
  ULONG ulFlags,
  LPMAPIERROR FAR * lppMAPIError
);

Parâmetros

Hresult

[in] Um identificador para o valor de erro gerado na chamada de método anterior para o objeto de suporte.

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 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 de erro 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 o MAPI não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e o MAPI dá suporte apenas ao Unicode.

Comentários

O método IMAPISupport::GetLastError é implementado para todos os objetos de suporte. Os chamadores podem fornecer aos seus usuários informações detalhadas sobre o erro, incluindo os dados da estrutura MAPIERROR em uma caixa de diálogo.

Notas para chamadores

Você pode usar o ponteiro para a estrutura MAPIERROR , se MAPI fornecer um, no parâmetro lppMAPIError somente se GetLastError retornar S_OK. Às vezes, o MAPI não pode determinar qual foi o último erro ou não tem mais nada a relatar sobre o erro. Nessa situação, lppMAPIError retorna um ponteiro para NULL.

Para obter mais informações sobre o método GetLastError , confira Erros Estendidos MAPI.

Para liberar toda a memória alocada pelo MAPI, chame a função MAPIFreeBuffer para a estrutura MAPIERROR retornada.

Confira também

MAPIERROR
MAPIFreeBuffer
IMAPISupport : Errosestendidos mapi do IUnknown