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 方法) 验证登录会话的状态。