WIZARDENTRY

适用于：Outlook 2013 | Outlook 2016

定义服务提供程序入口点函数，配置文件向导调用该函数以检索足够的信息以显示提供程序的配置属性表。

ULONG WIZARDENTRY(
  HINSTANCE hProviderDLLInstance,
  LPSTR FAR * lpcsResourceName,
  DLGPROC FAR * lppDlgProc,
  LPMAPIPROP lpMAPIProp,
  LPMAPISUPPORTOBJECT lpMapiSupportObject
);

参数

hProviderDLLInstance

[in]服务提供程序 DLL 的实例句柄。

lpcsResourceName

[out]指向包含对话资源全名的字符串的指针，该对话框资源应在配置期间由配置文件向导显示。 字符串的最大大小（包括 NULL 终止符）为 32 个字符。

lppDlgProc

[out]指向由配置文件向导调用的标准 Windows 对话框过程的指针，以通知提供程序各种事件。

lpMAPIProp

[in]指向属性接口实现的指针，该实现提供对配置属性的访问。

lpMapiSupportObject

[in]指向适用于此会话的 MAPI 支持对象的指针。

返回值

S_OK

已成功调用服务提供商的 WIZARDENTRY 函数。

MAPI_E_CALL_FAILED

意外或未知来源的错误阻止了操作完成。

备注

配置文件向导在准备好显示服务提供商的配置用户界面时调用基于 WIZARDENTRY 的函数。 当配置文件向导完成所有提供程序的配置后，它会通过调用 IMsgServiceAdmin：：ConfigureMsgService 将配置属性写入配置文件。

针对实现者的说明

基于 WIZARDENTRY 的函数的名称必须放在 MAPISVC.INF 的 WIZARD_ENTRY_NAME 条目中。

资源名称是将在“配置文件向导”窗格中呈现的对话框资源的名称。 传回的资源需要包含单个对话资源中的所有页面。 当配置文件向导收到此资源时，它会忽略对话框样式，但忽略控件样式，并将所有控件创建为“配置文件向导”页的子级。 所有控件最初都是隐藏的。 提供程序应确保其控件的坐标从零开始或从零开始，并且它们的最大宽度不超过 200 个对话框单位，最大高度不超过 150 个对话框单位。 低于 400 的控件标识符是为配置文件向导保留的。 配置文件向导在提供程序的用户界面上方以粗体文本显示提供程序的标题。

提供程序应保留 lpMAPIProp 参数中提供的属性接口指针以供将来参考。 配置文件向导仅处理最基本的属性集，提供程序可以使用属性接口实现来包括其他属性。 在配置期间，提供程序应将其配置属性添加到实现属性接口的对象。 配置所有提供程序后，配置文件向导会将这些属性添加到配置文件。

有关如何使用此函数的详细信息，请参阅 支持消息服务配置。