IMAPIControl::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标志且实现不支持 Unicode,或者未设置MAPI_UNICODE且实现仅支持 Unicode。

备注

服务提供商实现 IMAPIControl::GetLastError 方法,以提供有关先前失败的方法调用的信息。 MAPI 可以通过在消息或对话框中显示 MAPIERROR 结构中的数据,为用户提供有关错误的详细信息。

针对实现者的说明

对于每个错误,不需要将信息包含在 MAPIERROR 结构中。 可能无法确定以前的错误是什么。 如果有信息,请在 MAPIERROR 结构中返回S_OK和相应的数据。 如果没有可用信息,则返回 lppMAPIError 参数S_OK和指向 NULL 的指针。

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

另请参阅

MAPIERROR

MAPIFreeBuffer

IMAPIControl : IUnknown