IMAPIFormMgr::SelectMultipleForms
适用于:Outlook 2013 | Outlook 2016
显示一个对话框,使用户能够选择多个窗体,并返回描述这些窗体的表单信息对象的数组。
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
参数
ulUIParam
[in]显示对话框的父窗口的句柄。
ulFlags
[in]控制传入字符串类型的标志的位掩码。 可以设置以下标志:
MAPI_UNICODE
传入的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串采用 ANSI 格式。
pszTitle
[in]指向包含对话框描述文字的字符串的指针。 如果 pszTitle 参数为 NULL,则提供窗体的表单库提供程序将提供默认描述文字。
pfld
[in]指向要从中选择窗体的文件夹的指针。 如果 pfld 参数为 NULL,则从本地、个人或组织窗体容器中选择窗体。
pfrminfoarray
[in]指向为用户预选的表单信息对象的数组的指针。
ppfrminfoarray
[out]指向返回的表单信息对象数组的指针的指针。
返回值
S_OK
调用成功并返回了一个或多个预期值。
MAPI_E_BAD_CHARWIDTH
已设置MAPI_UNICODE标志且实现不支持 Unicode,或者未设置MAPI_UNICODE且实现仅支持 Unicode。
MAPI_E_USER_CANCEL
用户取消了操作,通常单击对话框中的“ 取消 ”按钮。
备注
表单查看者调用 IMAPIFormMgr::SelectMultipleForms 方法,以便首先显示一个对话框,使用户能够选择多个窗体,然后检索描述所选窗体的表单信息对象的数组。 SelectMultipleForms 对话框显示所有窗体,无论它们是否隐藏 (也就是说,其隐藏属性是否清晰) 。
针对实现者的说明
如果表单查看器传递 ulFlags 参数中的 MAPI_UNICODE 标志,则所有字符串都是 Unicode。 如果传递了MAPI_UNICODE,则不支持 Unicode 字符串的表单库提供程序应返回MAPI_E_BAD_CHARWIDTH。