IMsgServiceAdmin2::CreateMsgServiceEx

适用于:Outlook 2013 | Outlook 2016

将消息服务添加到当前配置文件,并返回新添加的服务 UID。

HRESULT CreateMsgServiceEx(
  LPSTR lpszService,
  LPSTR lpszDisplayName,
  ULONG_PTR ulUIParam,
  ULONG ulFlags, 
  LPMAPIUID lpuidService
);

参数

lpszService

[in]指向要添加的消息服务名称的指针。 此消息服务名称必须出现在 MapiSvc.inf 文件的 [Services] 部分中。

lpszDisplayName

[in]指向要添加的消息服务的显示名称的指针。 如果消息服务在 MapiSvc.inf 文件中设置了 PR_DISPLAY_NAME (PidTagDisplayName) 属性,则忽略 lpszDisplayName 参数。

ulUIParam

[in]此方法显示的任何对话框或窗口的父窗口的句柄。

ulFlags

[in]控制消息服务的安装方式的标志的位掩码。 可以设置以下标志:

MAPI_UNICODE

lpszService 和 lpszDisplayName 参数应转换为 LPWSTR 并解释为 Unicode 字符串。

SERVICE_NO_RESTART_WARNING

向配置文件添加新邮件服务时,MAPI 子系统通常根据各种情况和条件确定此操作需要重启 Outlook。 如果不包括SERVICE_NO_RESTART_WARNING标志,并且基于SERVICE_UI_ALWAYS和SERVICE_UI_ALLOWED标志允许 UI,并且至少有一个进程登录到当前配置文件,则此函数将显示消息“您必须重启 Outlook 才能使这些更改生效。包含SERVICE_NO_RESTART_WARNING标志将禁止显示该警告消息。

SERVICE_UI_ALLOWED

如果需要,允许使用消息服务配置 UI。

SERVICE_UI_ALWAYS

消息服务显示其配置属性表。

lpuidService

[out]指向已添加的消息服务的 UID 的指针。

返回值

S_OK

调用成功,并返回了预期的值。

MAPI_E_NOT_FOUND

邮件服务名称不在 MapiSvc.inf 的 [Services] 部分中。

备注

IMsgServiceAdmin2::CreateMsgServiceEx 方法将消息服务添加到当前配置文件。 CreateMsgServiceEx 调用消息服务的入口点函数来执行任何特定于服务的配置任务。 如果在 ulFlags 参数中设置了SERVICE_UI_ALLOWED标志,则安装的消息服务可以显示属性表,使用户能够配置其设置。

MapiSvc.inf 文件包含构成消息服务的提供程序列表以及每个提供程序的属性。 CreateMsgServiceEx 首先为消息服务创建新的配置文件部分,然后将该服务的所有信息从 MapiSvc.inf 文件复制到配置文件中,为每个提供程序创建新节。

从 MapiSvc.inf 复制所有信息后,使用 ulContext 参数中设置的 MSG_SERVICE_CREATE 值调用消息服务的入口点函数 MSGSERVICEENTRY。 如果在 CreateMsgServiceEx 方法的 ulFlags 参数中设置了SERVICE_UI_ALLOWED标志,则调用消息服务的入口点函数时,也会传递 ulUIParamulFlags 参数中的值。 服务提供商应显示其配置属性表,以便用户可以配置消息服务。

给调用方的说明

如果 CreateMsgServiceExlpuidService 参数不为 NULL,则 添加到 配置文件的消息服务的 PR_SERVICE_UID (PidTagServiceUid) 属性将在它指向的 GUID 中返回。

lpuidService 参数中 PR_SERVICE_UID 属性的值传递给 IMsgServiceAdmin::ConfigureMsgService 方法以配置服务。

警告

MAPI 子系统的 Microsoft Outlook 2010 实现不支持MAPI_UNICODE,如果使用它将失败。

重要

IMsgServiceAdmin2 接口由实现 IMsgServiceAdmin 接口的同一对象公开,并且自 Outlook 2003 以来一直使用 Outlook 的 MAPI 子系统实现。 其 IID 定义如下: #if !defined(INITGUID) || defined(USES_IID_IMsgServiceAdmin2)DEFINE_OLEGUID(IID_IMsgServiceAdmin2,0x00020387, 0, 0);>ulFlags SERVICE_NO_RESTART_WARNING 可能未在当前具有的可下载头文件中定义,在这种情况下,可以使用以下值将其添加到代码中: #define SERVICE_NO_RESTART_WARNING 0x00000080

另请参阅

IMsgServiceAdmin2:IMsgServiceAdminMFCMAPI 作为代码示例