IMAPIFormMgr::OpenFormContainer

适用于:Outlook 2013 | Outlook 2016

打开特定表单容器的 IMAPIFormContainer 接口。

HRESULT OpenFormContainer(
  HFRMREG hfrmreg,
  LPUNKNOWN lpunk,
  LPMAPIFORMCONTAINER FAR * lppfcnt
);

参数

hfrmreg

[in]一个 HFRMREG 枚举,指示要打开的表单库 (即要打开) 的表单容器。 HFRMREG 枚举是特定于表单库提供程序的枚举。 可能的 HFRMREG 值包括:

HFRMREG_DEFAULT

一个方便的表单容器。

HFRMREG_FOLDER

文件夹容器。

HFRMREG_PERSONAL

默认消息存储的容器。

HFRMREG_LOCAL

本地窗体容器。

lpunk

[in]指向为其打开接口的 对象的指针。 除非 hfrmreg 参数的值需要对象指针,否则 lpunk 参数必须为 null

lppfcnt

[out]指向返回的窗体容器对象的指针的指针。

返回值

S_OK

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

MAPI_E_NO_INTERFACE

lpunk 指向的对象不支持所需的接口。

备注

表单查看者调用 IMAPIFormMgr::OpenFormContainer 方法以打开特定表单容器的 IMAPIFormContainer 接口。 然后,可以使用此接口将窗体安装到窗体容器中以及从中删除窗体。

给调用方的说明

如果 hfrmreg 中的值HFRMREG_FOLDER,则 lpunk 中使用的接口标识符必须为非 null ,并且必须允许 IUnknown::QueryInterface 方法调用 IMAPIFolder 接口。

若要打开本地表单容器,必须使用对 OpenFormContainer 方法或 MAPIOpenLocalFormContainer 函数的调用;不能使用 IMAPIFormMgr::SelectFormContainer 方法使用户能够选择本地表单容器。

MFCMAPI 引用

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

文件 函数 Comment
MainDlg.cpp
CMainDlg::OnOpenFormContainer
MFCMAPI 使用 IMAPIFormMgr::OpenFormContainer 方法检索表单容器,以便可以呈现容器的内容。
MsgStoreDlg.cpp
CMsgStoreDlg::OnOpenFormContainer
MFCMAPI 使用 IMAPIFormMgr::OpenFormContainer 方法检索文件夹的表单容器,以便可以呈现容器的内容。

另请参阅

IMAPIFormContainer::InstallForm

IMAPIFormMgr::SelectFormContainer

MAPIOpenLocalFormContainer

IMAPIFormMgr : IUnknown

MFCMAPI 代码示例