IProfAdmin::CreateProfile

项目
12/18/2024

适用于：Outlook 2013 | Outlook 2016

创建新配置文件。

HRESULT CreateProfile(
  LPSTR lpszProfileName,
  LPSTR lpszPassword,
  ULONG_PTR ulUIParam,
  ULONG ulFlags
);

参数

lpszProfileName

[in]指向新配置文件名称的指针。

lpszPassword

[in]指向新配置文件的密码的指针。

ulUIParam

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

ulFlags

[in]控制如何创建配置文件的标志的位掩码。可以设置以下标志：

MAPI_APP_PROFILE

MAPI 应将此配置文件创建为“应用”配置文件，这会限制可发现性和交互性。

可能无法在所有 MAPI 实现中识别或支持此标志。

MAPI_DEFAULT_SERVICES

MAPI 应使用 Mapisvc.inf 文件的 [默认服务] 节中包含的消息服务填充新配置文件。

MAPI_DIALOG

可以显示要添加的消息服务中每个提供程序的配置属性表。

返回值

S_OK

新配置文件已创建。

MAPI_E_NO_ACCESS

指定的新配置文件已存在。

备注

IProfAdmin：：CreateProfile 方法将创建新的配置文件。

给调用方的说明

可以在应用程序安装时或在会话期间的任何时间调用 CreateProfile 。在安装时调用此方法时，许多配置设置来自 Mapisvc.inf 配置文件。在活动会话期间调用此方法时，设置来自通过一系列属性表提示的用户。

如果在 ulFlags 参数中设置了MAPI_DEFAULT_SERVICES标志， 则 CreateProfile 会为 Mapisvc.inf 文件的 [Default Services] 节中的每个消息服务调用消息服务入口点函数。调用每个消息服务入口点函数，并将 ulContext 参数设置为 MSG_SERVICE_CREATE。

如果同时设置了 MAPI_DIALOG 和 MAPI_DEFAULT_SERVICES 标志，则 ulUIParam 和 ulFlags 参数中的值也会传递给消息服务入口点函数。只有在将 Mapisvc.inf 文件中的所有可用信息添加到配置文件后，才会调用消息服务入口点函数。

新配置文件的名称及其密码长度最多为 64 个字符，可以包含以下字符：