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