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 方法选择窗体,并将有关表单的信息发送到一个或多个日志。 |