IMAPIFormMgr::ResolveMultipleMessageClasses
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Resolves a group of message classes to their forms within a form container, and returns an array of form information objects for those forms.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
pMsgClasses
[in] A pointer to an array that contains the names of the message classes to resolve.ulFlags
[in] A bitmask of flags that controls how the message classes are resolved. The following flag can be set:MAPIFORM_EXACTMATCH
Only message class strings that are an exact match should be resolved.MAPIFORM_LOCALONLY
Do not include cached forms.
pFolderFocus
[in] A pointer to the folder that contains the form whose message class is being resolved. The pFolderFocus parameter can be NULL.ppfrminfoarray
[out] A pointer to a pointer to an array of form information objects. If a form viewer passes NULL in the pMsgClasses parameter, the ppfrminfoarray parameter contains form information objects for all forms in the container.
Return Value
- S_OK
The call succeeded and has returned the expected value or values.
Remarks
Form viewers call the IMAPIFormMgr::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. The array of form information objects returned in ppfrminfoarray provides further access to each of the forms' properties.
Notes to Callers
To resolve a group of message classes to forms, a form viewer passes in an array of message class names to be resolved. To force the resolution to be exact (that is, to prevent resolution to a base class of the message class when an exactly matching form server is not available) the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.
Message class names are always ANSI strings, never Unicode.
If a message class cannot be resolved to a form, NULL is returned for that message class in the form information array. Therefore, even if the method returns S_OK, form viewers should not work on the assumption that all message classes have been successfully resolved. Instead, form viewers should check the values in the returned array.