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。

另请参阅

IMAPIFormMgr : IUnknown