IMAPIFormMgr::CreateForm

Область применения: Outlook 2013 | Outlook 2016

Открывает форму для создания нового сообщения на основе класса сообщений формы.

HRESULT CreateForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  IMAPIFormInfo pfrminfoToActivate,
  REFIID refiidToAsk,
  LPVOID FAR * ppvObj
);

Параметры

ulUIParam

[в] Дескриптор родительского окна для индикатора хода выполнения, который отображается при открытии формы. Параметр ulUIParam игнорируется, если флаг MAPI_DIALOG не установлен в параметре ulFlags .

ulFlags

[в] Битовая маска флагов, управляющая способом открытия формы. Можно задать следующий флаг:

MAPI_DIALOG

Отображает пользовательский интерфейс для предоставления состояния или запроса у пользователя дополнительных сведений. Если этот флаг не задан, пользовательский интерфейс не отображается.

pfrminfoToActivate

[в] Указатель на объект сведений о форме, используемый для открытия формы.

refiidToAsk

[в] Указатель на идентификатор интерфейса (IID) для интерфейса, возвращаемого для созданного объекта формы. Параметр refiidToAsk не должен иметь значение NULL.

ppvObj

[out] Указатель на указатель на возвращенный интерфейс.

Возвращаемое значение

S_OK

����� ������� � ������ ��������� ��������� ��� ��������.

MAPI_E_NO_INTERFACE

Запрошенный интерфейс не поддерживается объектом формы.

Замечания

Средства просмотра форм вызывают метод IMAPIFormMgr::CreateForm, чтобы открыть форму для создания нового сообщения на основе класса сообщений формы. CreateForm открывает форму, создав экземпляр сервера форм для этой формы, как описано в данном объекте сведений о форме. При необходимости CreateForm вызывает метод IMAPIFormMgr::P repareForm, чтобы скачать код сервера формы на диск пользователя.

Параметр pfrminfoToActivate должен указывать на объект сведений о форме, который был правильно разрешен.

После открытия формы средство просмотра вызывающей формы должно настроить сообщение с помощью интерфейса IPersistMessage и при необходимости настроить контекст представления для формы. Дополнительные сведения см. в разделе Запуск сервера форм.

Справочные материалы по MFCMAPI

Пример кода MFCMAPI указан в приведенной ниже таблице.

Файл	Функция	Comment
MAPIFormFunctions.cpp	CreateAndDisplayNewMailInFolder	MFCMAPI использует метод IMAPIFormMgr::CreateForm для создания формы перед ее отображением.

См. также

IMAPIFormMgr::PrepareForm

IPersistMessage : IUnknown

IMAPIFormMgr : IUnknown

MFCMAPI как пример кода

Запуск сервера форм