IMAPISupport::GetLastError

适用于:Outlook 2013 | Outlook 2016

返回一 个 MAPIERROR 结构,其中包含有关上一个支持对象错误的信息。

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

参数

hResult

[in]在上一次调用支持对象的方法中生成的错误值的句柄。

ulFlags

[in]控制返回的字符串类型的标志位掩码。 可以设置以下标志:

MAPI_UNICODE

lppMAPIError 参数中返回的 MAPIERROR 结构中的字符串采用 Unicode 格式。 如果未MAPI_UNICODE,则字符串采用 ANSI 格式。

lppMAPIError

[out]指向包含错误的版本、组件和上下文信息的 MAPIERROR 结构的指针的指针。 如果无法提供包含相应错误信息的 MAPIERROR 结构,可以将 lppMAPIError 参数设置为 NULL。

返回值

S_OK

调用成功并返回预期值。

MAPI_E_BAD_CHARWIDTH

设置MAPI_UNICODE MAPI 不支持 Unicode,或者未MAPI_UNICODE MAPI 仅支持 Unicode。

注解

IMAPISupport::GetLastError 方法针对所有支持对象实现。 调用方可以通过在对话框中包含 MAPIERROR 结构的数据来为用户提供有关错误的详细信息。

给调用方的说明

只有当 GetLastError 返回值时,才能在 lppMAPIError 参数中使用指向 MAPIERROR 结构的指针(如果 MAPI 提供了S_OK)。 有时 MAPI 无法确定上一个错误是什么,或者它仅能报告有关该错误的信息。 在这种情况下, lppMAPIError 会改为返回一个指向 NULL 的指针。

有关 GetLastError 方法的详细信息,请参阅 MAPI 扩展错误

若要释放 MAPI 分配的所有内存,请为返回的 MAPIERROR 结构调用 MAPIFreeBuffer 函数。

另请参阅

MAPIERROR
MAPIFreeBuffer
IMAPISupport : IUnknown MAPI 扩展错误