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 方法。

另请参阅

IMsgServiceAdmin::ConfigureMsgService

MAPIUID

IMsgServiceAdmin : IUnknown