IMAPIFormContainer::ResolveMessageClass

Article
05/31/2022

Applies to: Outlook 2013 | Outlook 2016

Resolves a message class to its form in a form container and returns a form information object for that form.

HRESULT ResolveMessageClass(
  LPCSTR szMessageClass,
  ULONG ulFlags,
  LPMAPIFORMINFO FAR * ppforminfo
);

Parameters

szMessageClass

[in] A string that names the message class being resolved. Message class names are always ANSI strings, never Unicode.

ulFlags

[in] A bitmask of flags that controls how the message class is resolved. The following flag can be set:

MAPIFORM_EXACTMATCH

Only message class strings that are an exact match should be resolved.

ppforminfo

[out] A pointer to a pointer to the returned form information object.

Return value

S_OK

The call succeeded and has returned the expected value or values.

MAPI_E_NOT_FOUND

The message class passed in the szMessageClass parameter does not match the message class for any form in the form container.

Remarks

Client applications call the IMAPIFormContainer::ResolveMessageClass method to resolve a message class to a form within a form container. The form information object returned in the ppforminfo parameter provides further access to the properties of the form with the given message class.

Notes to callers

To resolve a message class to a form, pass in the name of the message class to be resolved (for example, IPM.HelpDesk.Software). To force the resolution to be exact (that is, to prevent resolution to a base class of the message class), the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.

The class identifier for the resolved message class is returned as part of the form information object. Do not assume that the class identifier exists in the OLE library until after you call either the IMAPIFormMgr::PrepareForm or IMAPIFormMgr::CreateForm method.

MFCMAPI reference

For MFCMAPI sample code, see the following table.

File	Function	Comment
FormContainerDlg.cpp	CFormContainerDlg::OnResolveMessageClass	MFCMAPI uses the IMAPIFormContainer::ResolveMessageClass method to locate a form that is associated with a message class.