IMSLogon::OpenStatusEntry
适用于:Outlook 2013 | Outlook 2016
打开状态对象。
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPVOID FAR * lppEntry
);
参数
lpInterface
[in]指向接口标识符的指针 (IID) ,以便状态对象打开。 传递 NULL 指示将返回对象的标准接口 (在这种情况下, IMAPIStatus 接口) 。 还可以将 lpInterface 参数设置为 对象的相应接口的标识符。
ulFlags
[in]控制如何打开状态对象的标志的位掩码。 可以设置以下标志:
MAPI_MODIFY
请求读/写权限。 默认情况下,使用只读权限创建对象,客户端应用程序不应假定已授予读/写权限。
lpulObjType
[out]指向打开的对象类型的指针。
lppEntry
[out]指向打开的 对象的指针的指针。
返回值
S_OK
调用成功,并返回了预期的值。
备注
消息存储提供程序实现 IMSLogon::OpenStatusEntry 方法以打开状态对象。 然后,使用此状态对象使客户端能够调用 IMAPIStatus 方法。 例如,客户端可以使用 IMAPIStatus::SettingsDialog 方法重新配置消息存储登录会话,或使用 IMAPIStatus::ValidateState 方法来验证消息存储登录会话的状态。