IMAPIFormContainer::ResolveMessageClass
Область применения: Outlook 2013 | Outlook 2016
Разрешает класс сообщения в форму в контейнере формы и возвращает объект сведений о форме для этой формы.
HRESULT ResolveMessageClass(
LPCSTR szMessageClass,
ULONG ulFlags,
LPMAPIFORMINFO FAR * ppforminfo
);
Параметры
szMessageClass
[в] Строка, которая называет класс сообщений, который разрешается. Имена классов сообщений всегда являются строками ANSI, никогда не в Юникоде.
ulFlags
[в] Битовая маска флагов, управляющая разрешением класса сообщений. Можно задать следующий флаг:
MAPIFORM_EXACTMATCH
Следует разрешать только строки класса сообщений, которые являются точным совпадением.
ppforminfo
[out] Указатель на указатель на возвращенный объект сведений о форме.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
MAPI_E_NOT_FOUND
Класс сообщения, переданный в параметре szMessageClass , не соответствует классу сообщений для любой формы в контейнере формы.
Замечания
Клиентские приложения вызывают метод IMAPIFormContainer::ResolveMessageClass для разрешения класса сообщения в форму в контейнере формы. Объект сведений о форме, возвращаемый в параметре ppforminfo , предоставляет дополнительный доступ к свойствам формы с заданным классом сообщений.
Примечания для вызывающих методов
Чтобы разрешить класс сообщения в форму, передайте имя класса сообщения для разрешения (например, IPM.HelpDesk.Software). Чтобы заставить разрешение быть точным (то есть, чтобы предотвратить разрешение в базовый класс класса сообщения), флаг MAPIFORM_EXACTMATCH можно передать в параметре ulFlags .
Идентификатор класса разрешенного сообщения возвращается как часть объекта сведений о форме. Не предполагайте, что идентификатор класса существует в библиотеке OLE до тех пор, пока не вызовете метод IMAPIFormMgr::P repareForm или IMAPIFormMgr::CreateForm .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMessageClass |
MFCMAPI использует метод IMAPIFormContainer::ResolveMessageClass для поиска формы, связанной с классом сообщения. |