IMAPIControl::GetLastError
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma estrutura MAPIERROR que contém informações sobre o erro de controle de botão 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.
ulFlags
[in] Um 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] Um ponteiro para um ponteiro para uma 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 o provedor não puder fornecer uma estrutura MAPIERROR com informações apropriadas.
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
Os provedores de serviço implementam o método IMAPIControl::GetLastError para fornecer informações sobre uma chamada de método anterior que falhou. O MAPI pode fornecer aos usuários informações detalhadas sobre o erro exibindo os dados da estrutura MAPIERROR em uma caixa de diálogo ou mensagem.
Observações para implementadores
Você não precisa ter informações para incluir na estrutura MAPIERROR para cada erro. Talvez não seja possível determinar qual foi o erro anterior. Se você tiver informações, retorne S_OK e os dados apropriados na estrutura MAPIERROR . Se nenhuma informação estiver disponível, retorne S_OK e um ponteiro para NULL para o parâmetro lppMAPIError .
Para obter mais informações sobre o método GetLastError , confira Erros Estendidos MAPI.