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 会导致使用会话接口 IMAPISessionlpInterfaceDst 参数也可以设置为 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 方法。

另请参阅

IMsgServiceAdmin::ConfigureMsgService

MAPIUID

IMsgServiceAdmin : IUnknown