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 原型调用提供程序的回调函数。
如果添加到配置文件的服务提供程序支持配置文件向导页,则必须允许配置文件的编程配置。