IMAPIFormContainer::ResolveMultipleMessageClasses
Область применения: Outlook 2013 | Outlook 2016
Разрешает группу классов сообщений в их формы в контейнере формы и возвращает массив объектов сведений о форме для этих форм.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Параметры
pMsgClassArray
[в] Указатель на массив, содержащий имена классов сообщений для разрешения. Имена классов сообщений всегда являются строками ANSI, никогда не в Юникоде.
ulFlags
[в] Битовая маска флагов, управляющая способом разрешения классов сообщений. Можно задать следующий флаг:
MAPIFORM_EXACTMATCH
Следует разрешать только строки класса сообщений, которые являются точным совпадением.
ppfrminfoarray
[out] Указатель на указатель на массив объектов сведений о форме. Если клиентское приложение передает значение NULL в параметре pMsgClassArray , параметр ppfrminfoarray содержит объекты сведений о форме для всех форм в контейнере.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
Замечания
Клиентские приложения вызывают метод IMAPIFormContainer::ResolveMultipleMessageClasses для разрешения группы классов сообщений в формы контейнера. Массив объектов сведений о форме, возвращаемых в параметре ppfrminfoarray , предоставляет дополнительный доступ к каждому из свойств форм.
Примечания для вызывающих методов
Чтобы разрешить группу классов сообщений в формы, передайте массив имен классов сообщений для разрешения. Чтобы заставить разрешение быть точным (то есть, чтобы предотвратить разрешение в базовый класс класса сообщения), флаг MAPIFORM_EXACTMATCH можно передать в параметре ulFlags .
Если класс сообщения не может быть разрешен в форму, для этого класса сообщения в массиве сведений о форме возвращается значение NULL. Поэтому даже если метод возвращает S_OK, не следует предполагать, что все классы сообщений успешно разрешены. Вместо этого проверка значения в возвращаемом массиве.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMultipleMessageClasses |
MFCMAPI использует метод IMAPIFormContainer::ResolveMultipleMessageClasses для поиска формы, связанной с набором классов сообщений. |