IMAPIFormMgr::SelectForm

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

Представляет диалоговое окно, позволяющее пользователю выбрать форму, и возвращает объект сведений о форме, описывающий форму.

HRESULT SelectForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFO FAR * ppfrminfoReturned
);

Параметры

ulUIParam

[в] Дескриптор родительского окна отображаемого диалогового окна.

ulFlags

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

MAPI_UNICODE

Переданные строки имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.

pszTitle

[в] Указатель на строку, содержащую подпись диалогового окна. Если параметр pszTitle имеет значение NULL, поставщик библиотеки форм предоставляет подпись по умолчанию.

pfld

[в] Указатель на папку, из которой нужно выбрать форму. Если параметр pfld имеет значение NULL, форма может быть выбрана из локального, личного или организационного контейнера формы.

ppfrminfoReturned

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

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

S_OK

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

MAPI_E_BAD_CHARWIDTH

Либо был установлен флаг MAPI_UNICODE и реализация не поддерживает Юникод, либо MAPI_UNICODE не задан и реализация поддерживает только Юникод.

MAPI_E_USER_CANCEL

Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.

Замечания

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

Примечания для вызывающих методов

В диалоговом окне Выбор формы отображаются только формы, которые не являются скрытыми (то есть формы со скрытыми свойствами). Если средство просмотра форм передает флаг MAPI_UNICODE в параметре ulFlags , все строки будут в Юникоде. Поставщики библиотек форм, которые не поддерживают строки Юникода, должны возвращать MAPI_E_BAD_CHARWIDTH при передаче MAPI_UNICODE.

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

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

Файл	Функция	Comment
FolderDlg.cpp	CFolderDlg::OnSelectForm	MFCMAPI использует метод IMAPIFormMgr::SelectForm для выбора формы и отправки сведений о форме в один или несколько журналов.

См. также

IMAPIFormMgr : IUnknown

Mfcmapi (en) � �������� ������� ����