IPersistMessage::GetLastError
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma estrutura MAPIERROR que contém informações sobre o erro anterior no objeto de formulário.
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.
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 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 formulário não puder fornecer informações apropriadas para uma estrutura MAPIERROR .
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 provedor de catálogo de endereços não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e o provedor de catálogo de endereços dá suporte apenas ao Unicode.
Comentários
Os objetos form implementam o método IPersistMessage::GetLastError para fornecer informações sobre uma chamada de método anterior que falhou. Os visualizadores de formulário podem fornecer aos usuários informações detalhadas sobre o erro, incluindo os dados da estrutura MAPIERROR em uma caixa de diálogo.
Uma chamada para GetLastError não afeta o estado do formulário. Quando GetLastError retorna, o formulário permanece no estado em que estava antes da chamada ser feita.
Notas para chamadores
Você pode usar a estrutura MAPIERROR , se o formulário fornecer um, que é apontado pelo parâmetro lppMAPIError somente se GetLastError retornar S_OK. Às vezes, o formulário não pode determinar qual foi o último erro ou não tem mais nada a relatar sobre o erro. Nessa situação, o formulário retorna um ponteiro para NULL em lppMAPIError .
Para obter mais informações sobre o método GetLastError , confira Erros Estendidos MAPI.