IMAPIStatus::SettingsDialog
适用于：Outlook 2013 | Outlook 2016
显示一个属性表，该属性表允许用户更改服务提供商的配置 MAPI 实现的状态对象不支持此方法。
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
参数
ulUIParam
[in]配置属性表的父窗口的句柄。
ulFlags
[in]控制属性表显示的标志的位掩码。 可以设置以下标志：
UI_READONLY
建议提供程序不应允许用户更改配置属性。 此标志只是一个建议;可以忽略它。
返回值
S_OK
配置属性表已成功显示。
MAPI_E_NO_SUPPORT
状态对象不支持此方法，如 PR_RESOURCE_METHODS (PidTagResourceMethods) 属性中缺少 STATUS_SETTINGS_DIALOG 标志所示。
备注
IMAPIStatus：：SettingsDialog 方法显示配置属性表。 所有服务提供商都应支持 SettingsDialog 方法，但不是必需的。 服务提供商可以实现自己的属性表，或使用支持对象的 IMAPISupport：:D oConfigPropsheet 方法中提供的实现。 DoConfigPropsheet 生成可读/写属性表。
针对实现者的说明
如果远程传输提供程序具有任何设置，则应执行以下操作：
打开传输提供程序的配置文件部分。
从配置文件获取传输提供程序的属性设置。
在对话框中显示属性设置。
如果对话框允许编辑属性设置，检查新设置有效，并将其存储回传输提供程序的配置文件部分。
返回S_OK或上述步骤期间返回的任何错误值。
给调用方的说明
可以使用 通过 SettingsDialog 显示的属性表来执行各种任务，例如：
指定默认消息存储。
指定传输顺序。
指定用于浏览的默认通讯簿容器。
指定用于解析不明确名称的搜索顺序。
指定默认的个人通讯簿。
服务提供程序可以实现读/写、只读或权限混合的属性表，具体取决于属性。 服务提供商可以通过设置属性限制来对各个属性实现不同的权限。 属性表的默认模式是读/写。 可以通过在对 SettingsDialog 的调用中设置 UI_READONLY 标志来请求只读属性表。 能够实现只读属性表的服务提供商可以执行此操作。 但是，由于某些服务提供程序无法替代默认模式，因此必须准备好处理任一类型的属性表。
由于此操作始终涉及用户界面，因此只有交互式客户端应调用 SettingsDialog。