IMAPIFormMgr::SelectMultipleForms

Статья
04/04/2023

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

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

HRESULT SelectMultipleForms(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFOARRAY pfrminfoarray,
  LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

Параметры

ulUIParam

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

ulFlags

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

MAPI_UNICODE

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

pszTitle

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

pfld

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

pfrminfoarray

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

ppfrminfoarray

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

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

S_OK

Вызов выполнен успешно и возвращает ожидаемое значение или значения.

MAPI_E_BAD_CHARWIDTH

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

MAPI_E_USER_CANCEL

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

Замечания

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

Примечания для исполнителей

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

См. также

IMAPIFormMgr : IUnknown

Поделиться через