IXPLogon::OpenStatusEntry

适用于:Outlook 2013 | Outlook 2016

打开传输提供程序的状态对象。

HRESULT OpenStatusEntry(
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPMAPISTATUS FAR * lppEntry
);

参数

lpInterface

[in]指向传输登录对象的接口标识符 (IID) 的指针。 传递 NULL 将返回 IMAPIStatus 接口。 还可以将 lpInterface 参数设置为 对象的接口的标识符。

ulFlags

[in]控制如何打开状态对象的标志的位掩码。 可以设置以下标志:

MAPI_MODIFY

请求读/写权限。 默认接口为只读。

lpulObjType

[out]指向打开的对象类型的指针。

lppEntry

[out]指向打开状态对象的指针的指针。

返回值

S_OK

调用成功并返回了一个或多个预期值。

备注

当客户端应用程序为传输提供程序的状态表行中的条目标识符调用 OpenEntry 方法时,MAPI 后台处理程序调用 IXPLogon::OpenStatusEntry 方法。 OpenStatusEntry 打开一个对象,该对象具有与此特定传输提供程序登录关联的 IMAPIStatus 接口。 然后,此对象用于使客户端应用程序能够调用 IMAPIStatus 方法 (例如,使用 IMAPIStatus::SettingsDialog 方法重新配置登录会话,或使用 IMAPIStatus::ValidateState 方法) 验证登录会话的状态。

另请参阅

IMAPIStatus : IMAPIProp

IXPLogon : IUnknown