LAUNCHWIZARDENTRY

适用于：Outlook 2013 | Outlook 2016

定义一个函数，该函数启动配置文件向导应用程序，以便将一个或多个消息服务添加到配置文件。

属性	值
标头文件：	Mapiwz.h
由实现的已定义函数：	MAPI
由调用的已定义函数：	客户端应用程序

HRESULT LAUNCHWIZARDENTRY(
  HWND hParentWnd,
  ULONG ulFlags,
  LPCSTR FAR * lppszServiceNameToAdd,
  ULONG cbBufferMax,
  LPSTR lpszNewProfileName
);

参数

hParentWnd

[in]调用方父窗口的句柄。 如果调用方没有父窗口，则 hParentWnd 参数应为 NULL。

ulFlags

[in]指示配置文件向导选项的标志的位掩码。 可以设置以下标志：

MAPI_PW_ADD_SERVICE_ONLY

配置文件向导仅添加通过 lppszServiceNameToAdd 参数列出的消息服务，而不显示其用于选择消息服务的页面。

MAPI_PW_FIRST_PROFILE

要创建的配置文件是此工作站的第一个配置文件。

MAPI_PW_HIDE_SERVICES_LIST

不应显示用于选择消息服务的“配置文件向导”页。

MAPI_PW_LAUNCHED_BY_CONFIG

配置文件向导由 控制面板 配置应用程序启动。

MAPI_PW_PROVIDER_UI_ONLY

应仅显示服务提供商的配置对话框，并且不应显示配置文件向导的页面。 仅当设置了MAPI_PW_ADD_SERVICE_ONLY标志时，才能设置此标志。

lppszServiceNameToAdd

[in]指向字符串数组的指针，该数组包含要添加到配置文件的消息服务的名称。 数组必须以 NULL 值结尾。

cbBufferMax

[in] lpszNewProfileName 参数指向的缓冲区的大小。

lpszNewProfileName

[out]指向字符串缓冲区的指针，其中基于 LAUNCHWIZARDENTRY 的函数返回创建的配置文件的名称。

返回值

S_OK

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

MAPI_E_CALL_FAILED

意外或未知来源的错误阻止了操作完成。 可能的情况包括未能为配置文件向导初始化 MAPI 子系统、无法访问默认配置文件以及从对话框返回错误。

备注

LAUNCHWIZARDENTRY 函数原型的 MAPI 实现是 MAPI 配置文件向导应用程序的入口点。 MAPI 将此入口点 命名为 LaunchWizard。

在 ulFlags 参数中设置MAPI_PW_ADD_SERVICE_ONLY标志时，以下规则适用：

• MAPI_PW_LAUNCHED_BY_CONFIG标志禁止显示欢迎页。

• 仅当没有默认配置文件时，MAPI_PW_HIDE_SERVICES_LIST和MAPI_PW_PROVIDER_UI_ONLY标志才有用。 在这种情况下，这些标志确定要显示的“配置文件向导”页。

• 如果存在默认配置文件，则不会显示任何配置文件向导页。

• 如果存在默认配置文件，则仅通过 lppszServiceNameToAdd 参数列出一个消息服务，并且该消息服务已在默认配置文件中，则配置文件向导将返回S_OK而不向配置文件添加任何内容。

对于要添加到配置文件的每个消息服务，配置文件向导会基于 MSGSERVICEENTRY 原型调用服务的入口点函数。 对于从要添加到配置文件的消息服务中选择的每个服务提供商，配置文件向导会基于 WIZARDENTRY 原型调用提供程序的入口点函数。 在交互式配置期间，属性页中的每个用户事件都会导致配置文件向导基于 SERVICEWIZARDDLGPROC 原型调用提供程序的回调函数。

如果添加到配置文件的服务提供程序支持配置文件向导页，则必须允许配置文件的编程配置。