IXPLogon::ValidateState
适用于：Outlook 2013 | Outlook 2016
检查传输提供程序的外部状态。
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
参数
ulUIParam
[in]此方法显示的任何对话框或窗口的父窗口的句柄。
ulFlags
[in]控制状态检查的执行方式和状态结果检查的标志的位掩码。 可以设置以下标志：
ABORT_XP_HEADER_OPERATION
用户取消了操作，通常单击对话框中的“ 取消 ”按钮。 传输提供程序可以选择继续处理操作，也可以中止操作并返回MAPI_E_USER_CANCELED。
CONFIG_CHANGED
通过使 MAPI 后台处理程序调用其 IXPLogon：：AddressTypes 方法来验证当前加载的传输提供程序的状态。 此标志还为 MAPI 后台处理程序提供了更正关键传输提供程序故障的机会，而无需强制客户端应用程序注销，然后再次登录。
FORCE_XP_CONNECT
用户选择了连接操作。 当此标志与 REFRESH_XP_HEADER_CACHE 或 PROCESS_XP_HEADER_CACHE 标志一起使用时，连接操作将不进行缓存。
FORCE_XP_DISCONNECT
用户选择了断开连接操作。 当此标志与REFRESH_XP_HEADER_CACHE或PROCESS_XP_HEADER_CACHE一起使用时，断开连接操作将不进行缓存。
PROCESS_XP_HEADER_CACHE
应处理标头缓存表中的条目，应下载标有 MSGSTATUS_REMOTE_DOWNLOAD 标志的所有消息，并删除所有使用 MSGSTATUS_REMOTE_DELETE 标志标记的消息。 应移动同时设置了MSGSTATUS_REMOTE_DOWNLOAD和MSGSTATUS_REMOTE_DELETE的邮件。
REFRESH_XP_HEADER_CACHE
应下载新的邮件头列表，并清除所有消息状态标记标志。
SUPPRESS_UI
防止传输提供程序显示用户界面。
返回值
S_OK
调用成功并返回了一个或多个预期值。
MAPI_E_BUSY
另一个操作正在进行中;应允许它完成，或者应在尝试此操作之前将其停止。
MAPI_E_NO_SUPPORT
涉及的远程传输提供程序不支持用户界面，客户端应用程序本身应显示对话框。
MAPI_E_USER_CANCEL
用户取消了操作，通常单击对话框中的“ 取消 ”按钮。
备注
MAPI 后台处理程序调用 IXPLogon：：ValidateState 方法以支持对状态对象的 IMAPIStatus：：ValidateState 方法的调用。 传输提供程序应响应 IXPLogon：：ValidateState 调用，就像 MAPI 后台处理程序已打开当前登录会话的状态对象，然后在该对象上调用 IMAPIStatus：：ValidateState 一样。
为了支持 IMAPIStatus：：ValidateState 的实现，MAPI 后台处理程序对配置文件会话中运行的所有活动传输提供程序的所有登录对象调用 IXPLogon：：ValidateState 。