IMAPISupport : IUnknown
适用于：Outlook 2013 | Outlook 2016
为通常由服务提供商和消息服务入口点函数执行的任务提供实现。 当 MAPI 调用其提供程序对象的登录方法时，服务提供商会收到指向其支持对象的指针。 消息服务在调用其入口点函数时接收其支持对象指针。
| 属性 | 值 |
|---|---|
| 标头文件： |
Mapispi.h |
| 公开者： |
支持对象 |
| 实现者： |
MAPI |
| 调用者： |
服务提供程序 |
| 接口标识符： |
IID_IMAPISup |
| 指针类型： |
LPMAPISUP |
Vtable 顺序
| 成员 | 说明 |
|---|---|
| GetLastError |
返回一个 MAPIERROR 结构，该结构包含有关上一个支持对象错误的信息。 |
| GetMemAllocRoutines |
检索 MAPI 内存分配和解除分配函数的地址， (MAPIAllocateBuffer、 MAPIAllocateMore 和 MAPIFreeBuffer) 。 |
| Subscribe |
注册建议接收器以通过 MAPI 接收通知。 |
| 取消订阅 |
取消发送以前通过调用 Subscribe 方法建立的通知的责任。 |
| Notify |
将指定事件的通知发送到最初通过 Subscribe 方法为通知注册的建议源。 |
| ModifyStatusRow |
通过添加新行或修改现有行来修改状态表。 |
| OpenProfileSection |
打开当前配置文件的一部分，并返回 IProfSect 指针以供进一步访问 |
| RegisterPreprocessor |
(符合 PreprocessMessage 原型) 的函数注册传输提供程序的预处理器函数。 |
| NewUID |
创建新的 MAPIUID 结构，用作唯一标识符。 |
| MakeInvalid |
将对象标记为不可用。 |
| SpoolerYield |
将 CPU 控制权授予 MAPI 后台处理程序，以便它可以执行它认为必要的任何任务。 |
| SpoolerNotify |
通知 MAPI 后台处理程序状态更改或服务请求。 |
| CreateOneOff |
为一次性地址创建入口标识符。 |
| SetProviderUID |
注册唯一表示服务提供程序的 MAPIUID 结构。 |
| CompareEntryIDs |
比较两个条目标识符，以确定它们是否引用同一对象。 |
| OpenTemplateID |
打开外部通讯簿提供程序中的收件人条目。 |
| OpenEntry |
打开对象并返回接口指针以供进一步访问。 |
| GetOneOffTable |
返回指向 MAPI 一次性表的指针， (所有通讯簿提供商都支持) 创建新收件人的模板列表。 |
| 地址 |
显示“公用地址”对话框。 |
| 详细信息 |
显示一个对话框，该对话框显示有关特定通讯簿条目的详细信息。 |
| NewEntry |
将新收件人直接添加到通讯簿容器或传出邮件的收件人列表中。 |
| DoConfigPropsheet |
显示配置属性表。 |
| CopyMessages |
将邮件从一个文件夹复制或移动到另一个文件夹。 |
| CopyFolder |
将文件夹从其当前父文件夹复制或移动到另一个父文件夹。 |
| DoCopyTo |
将一个对象的所有属性（特排除的属性除外）复制或移动到另一个对象。 |
| DoCopyProps |
将对象的一个或多个属性复制或移动到另一个对象。 |
| DoProgressDialog |
检索显示进度指示器的进度对象。 |
| ReadReceipt |
为邮件生成已读或未读报告。 |
| PrepareSubmit |
准备要提交到 MAPI 后台处理程序的消息。 |
| ExpandRecips |
完成邮件的收件人列表，展开特定的通讯组列表。 |
| DoSentMail |
处理已发送的消息。 |
| OpenAddressBook |
提供对通讯簿的访问权限。 |
| CompleteMsg |
对消息执行后处理。 |
| StoreLogoffTransports |
请求消息存储的有序发布。 |
| StatusRecips |
生成传递和非交付报告。 |
| WrapStoreEntryID |
将消息存储的内部条目标识符转换为 MAPI 标准格式的条目标识符。 |
| ModifyProfile |
永久更改消息存储配置文件部分。 |
| IStorageFromStream |
实现存储对象以访问流。 |
| GetSvcConfigSupportObj |
创建消息服务支持对象。 |
备注
通讯簿、消息存储、传输提供程序和消息服务都有自己的支持对象。 服务提供商和消息服务在其支持对象中调用方法，作为其实现其他接口方法的一部分。 每个不同的支持对象都有应用于其调用方的方法的完整实现;不适用的方法返回MAPI_E_NO_SUPPORT。 通讯簿提供程序支持对象具有以下方法的实现：
| 方法 | ... | ... |
|---|---|---|
| 地址 |
CompareEntryIDs |
CreateOneOff |
| 详细信息 |
DoConfigPropsheet |
DoProgressDialog |
| GetLastError |
GetMemAllocRoutines |
GetOneOffTable |
| IStorageFromStream |
GetSvcConfigSupportObj |
MakeInvalid |
| ModifyStatusRow |
NewEntry |
NewUID |
| Notify |
OpenAddressBook |
OpenEntry |
| OpenProfileSection |
OpenTemplateID |
SetProviderUID |
| Subscribe |
取消订阅 |
WrapStoreEntryID |
消息存储提供程序支持对象具有以下方法的实现：
| 方法 | ... | ... |
|---|---|---|
| CompareEntryIDs |
CompleteMsg |
CopyFolder |
| CopyMessages |
CreateOneOff |
DoCopyProps |
| DoCopyTo |
DoConfigPropsheet |
DoProgressDialog |
| DoSentMail |
ExpandRecips |
GetLastError |
| GetMemAllocRoutines |
GetSvcConfigSupportObj |
MakeInvalid |
| IStorageFromStream |
ModifyProfile |
ModifyStatusRow |
| NewUID |
Notify |
OpenAddressBook |
| OpenEntry |
OpenProfileSection |
PrepareSubmit |
| ReadReceipt |
SetProviderUID |
SpoolerNotify |
| StoreLogoffTransports |
Subscribe |
取消订阅 |
| WrapStoreEntryID |
传输提供程序支持对象具有以下方法的实现：
| 方法 | ... | ... |
|---|---|---|
| DoConfigPropsheet |
CompareEntryIDs |
CreateOneOff |
| GetMemAllocRoutines |
GetSvcConfigSupportObj |
GetLastError |
| IStorageFromStream |
MakeInvalid |
ModifyStatusRow |
| OpenAddressBook |
RegisterPreprocessor |
NewUID |
| Notify |
OpenProfileSection |
OpenEntry |
| StatusRecips |
SpoolerNotify |
SpoolerYield |
| WrapStoreEntryID |
Subscribe |
取消订阅 |
消息服务支持对象具有以下方法的实现：
| 方法 | ... |
|---|---|
| DoConfigPropsheet |
GetLastError |
| GetMemAllocRoutines |
GetSvcConfigSupportObj |
| MakeInvalid |
NewUID |
| OpenProfileSection |