IMAPIStatus : IMAPIProp
适用于：Outlook 2013 | Outlook 2016
提供有关 MAPI 子系统、集成通讯簿和 MAPI 后台处理程序的状态信息。 服务提供商实现 IMAPIStatus 以提供有关其自身状态的信息。
| 属性 | 值 |
|---|---|
| 标头文件： |
Mapidefs.h |
| 公开者： |
状态对象 |
| 实现者： |
服务提供商和 MAPI |
| 调用者： |
客户端应用程序 |
| 接口标识符： |
IID_IMAPIStatus |
| 指针类型： |
LPMAPISTATUS |
| 事务模型： |
非事务处理 |
Vtable 顺序
| 属性 | 值 |
|---|---|
|
ValidateState |
确认 MAPI 资源或服务提供程序可用的外部状态信息。 |
|
SettingsDialog |
显示一个属性表，该属性表使用户能够更改服务提供商的配置。 |
|
ChangePassword |
在不显示用户界面的情况下修改服务提供商的密码。 |
|
FlushQueues |
强制等待发送或接收的所有消息立即上传或下载。 |
| 必需属性 | Access |
|---|---|
|
PR_DISPLAY_NAME (PidTagDisplayName) |
读/写 |
|
PR_PROVIDER_DISPLAY (PidTagProviderDisplay) |
读/写 |
|
PR_PROVIDER_DLL_NAME (PidTagProviderDllName) |
只读 |
|
PR_RESOURCE_FLAGS (PidTagResourceFlags) |
只读 |
|
PR_RESOURCE_METHODS (PidTagResourceMethods) |
只读 |
|
PR_RESOURCE_TYPE (PidTagResourceType) |
只读 |
|
PR_STATUS_CODE (PidTagStatusCode) |
只读 |
备注
MAPI 实现的状态对象支持以下方法：
| Status 对象 | 支持的方法 |
|---|---|
| MAPI 子系统 |
仅 ValidateState |
| MAPI 通讯簿 |
仅 ValidateState |
| MAPI 后台处理程序 |
ValidateState 和 FlushQueues |
MAPI 实现的状态对象必须具有 IMAPIProp 接口方法的只读版本并支持 ValidateState 方法。 传输提供程序还应支持 FlushQueues。 所有提供程序都应支持 SettingsDialog;对 ChangePassword 的支持是可选的。
客户端使用状态对象来执行配置并了解会话的状态。 他们通过调用服务提供程序登录对象的 OpenStatusEntry 方法或 IMAPISession：：GetStatusTable 方法来访问状态对象以检索状态对象。