IMsgServiceAdmin::CopyMsgService
适用于:Outlook 2013 | Outlook 2016
将消息服务复制到配置文件中。
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
参数
lpUID
[in]指向 MAPIUID 结构的指针,该结构包含要复制的消息服务的唯一标识符。
lpszDisplayName
[in]此参数已弃用。
lpInterfaceToCopy
[in]指向接口标识符的指针 (IID) ,该接口表示用于访问要复制的消息服务的配置文件部分的接口。 传递 NULL 会导致使用标准配置文件部分接口 IProfSect。
lpInterfaceDst
[in]指向 IID 的指针,该指针表示用于访问 lpObjectDst 参数指向的对象的接口。 传递 NULL 会导致使用会话接口 IMAPISession。 lpInterfaceDst 参数也可以设置为 IID_IMsgServiceAdmin。
lpObjectDst
[in]指向会话或消息服务管理对象的指针的指针。 对象的类型应对应于 在 lpInterfaceDst 中传递的接口标识符。 有效的对象指针是 LPMAPISESSION 和 LPSERVICEADMIN。
ulUIParam
[in]此方法显示的任何对话框或窗口的父窗口的句柄。
ulFlags
[in]控制消息服务的复制方式的标志的位掩码。 可以设置以下标志:
SERVICE_UI_ALWAYS
请求消息服务始终显示配置属性表。
返回值
S_OK
已成功复制消息服务。
MAPI_E_NO_ACCESS
消息服务已在配置文件中,不允许自身的多个实例。
MAPI_E_NOT_FOUND
lpUID 指向的 MAPIUID 不引用现有消息服务。
备注
IMsgServiceAdmin::CopyMsgService 方法将消息服务复制到配置文件(活动配置文件或其他配置文件)。 包含要复制的消息服务的配置文件和目标不一定是同一个配置文件,但可以。
不为复制操作调用消息服务的入口点函数。 复制的消息服务具有与其原始消息服务相同的配置设置。 若要更改这些设置,客户端应调用 IMsgServiceAdmin::ConfigureMsgService 方法。