IMAPIFormMgr::SelectForm

适用于:Outlook 2013 | Outlook 2016

显示一个对话框,使用户能够选择窗体,并返回描述该窗体的表单信息对象。

HRESULT SelectForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFO FAR * ppfrminfoReturned
);

参数

ulUIParam

[in]显示对话框的父窗口的句柄。

ulFlags

[in]控制传入字符串类型的标志的位掩码。 可以设置以下标志:

MAPI_UNICODE

传入的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串采用 ANSI 格式。

pszTitle

[in]指向包含对话框描述文字的字符串的指针。 如果 pszTitle 参数为 NULL,则表单库提供程序将提供默认描述文字。

pfld

[in]指向要从中选择窗体的文件夹的指针。 如果 pfld 参数为 NULL,则可以从本地、个人或组织窗体容器中选择窗体。

ppfrminfoReturned

[out]指向返回的表单信息对象的指针的指针。

返回值

S_OK

调用成功,并返回了预期的值。

MAPI_E_BAD_CHARWIDTH

已设置MAPI_UNICODE标志且实现不支持 Unicode,或者未设置MAPI_UNICODE且实现仅支持 Unicode。

MAPI_E_USER_CANCEL

用户取消了操作,通常单击对话框中的“ 取消 ”按钮。

备注

表单查看者调用 IMAPIFormMgr::SelectForm 方法,首先显示一个对话框,使用户能够选择窗体,然后检索描述所选窗体的表单信息对象。 该对话框限制用户选择单个窗体。

给调用方的说明

SelectForm 对话框仅显示未隐藏的窗体 (即清除其隐藏属性的窗体) 。 如果表单查看器传递 ulFlags 参数中的 MAPI_UNICODE 标志,则所有字符串都是 Unicode。 如果传递了MAPI_UNICODE,则不支持 Unicode 字符串的表单库提供程序应返回MAPI_E_BAD_CHARWIDTH。

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 Comment
FolderDlg.cpp
CFolderDlg::OnSelectForm
MFCMAPI 使用 IMAPIFormMgr::SelectForm 方法选择窗体,并将有关表单的信息发送到一个或多个日志。

另请参阅

IMAPIFormMgr : IUnknown

MFCMAPI 代码示例