IMAPIFormMgr::ResolveMultipleMessageClasses

Статья
04/04/2023

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

Разрешает группу классов сообщений в их формы в контейнере формы и возвращает массив объектов сведений о форме для этих форм.

HRESULT ResolveMultipleMessageClasses(
  LPSMESSAGECLASSARRAY pMsgClasses,
  ULONG ulFlags,
  LPMAPIFOLDER pFolderFocus,
  LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

Параметры

pMsgClasses

[в] Указатель на массив, содержащий имена классов сообщений для разрешения.

ulFlags

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

MAPIFORM_EXACTMATCH

Следует разрешать только строки класса сообщений, которые являются точным совпадением.

MAPIFORM_LOCALONLY

Не включайте кэшированные формы.

pFolderFocus

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

ppfrminfoarray

[out] Указатель на указатель на массив объектов сведений о форме. Если средство просмотра форм передает значение NULL в параметре pMsgClasses , параметр ppfrminfoarray содержит объекты сведений о форме для всех форм в контейнере.

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

S_OK

�� .

Замечания

Средства просмотра форм вызывают метод IMAPIFormMgr::ResolveMultipleMessageClasses для разрешения группы классов сообщений в формы в контейнере формы. Массив объектов сведений о форме, возвращаемых в ppfrminfoarray , предоставляет дополнительный доступ к свойствам каждой формы.

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

Чтобы разрешить группу классов сообщений в формы, средство просмотра форм передает массив имен классов сообщений для разрешения. Чтобы принудить разрешение быть точным (т. е. для предотвращения разрешения в базовый класс класса сообщений, когда сервер точно соответствующей формы недоступен), флаг MAPIFORM_EXACTMATCH можно передать в параметре ulFlags .

Имена классов сообщений всегда являются строками ANSI, никогда не в Юникоде.

Если класс сообщения не может быть разрешен в форму, для этого класса сообщения в массиве сведений о форме возвращается значение NULL. Таким образом, даже если метод возвращает S_OK, средства просмотра форм не должны работать при условии, что все классы сообщений успешно разрешены. Вместо этого средства просмотра форм должны проверка значения в возвращаемом массиве.

См. также

IMAPIFormMgr::ResolveMessageClass

IMAPIFormMgr : IUnknown

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