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