IMAPIFormMgr::OpenFormContainer
Область применения: Outlook 2013 | Outlook 2016
Открывает интерфейс IMAPIFormContainer для определенного контейнера формы.
HRESULT OpenFormContainer(
HFRMREG hfrmreg,
LPUNKNOWN lpunk,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
Параметры
hfrmreg
[в] Перечисление HFRMREG, указывающее открываемую библиотеку форм (то есть контейнер формы для открытия). Перечисление HFRMREG — это перечисление, относящееся к поставщику библиотеки форм. Возможные значения HFRMREG:
HFRMREG_DEFAULT
Удобный контейнер формы.
HFRMREG_FOLDER
Контейнер папок.
HFRMREG_PERSONAL
Контейнер для хранилища сообщений по умолчанию.
HFRMREG_LOCAL
Локальный контейнер формы.
lpunk
[в] Указатель на объект, для которого открыт интерфейс. Параметр lpunk должен иметь значение NULL , если для параметра hfrmreg не требуется указатель объекта.
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