IMAPIFormContainer::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 in a form container and returns an array of form information objects for those forms.

HRESULT ResolveMultipleMessageClasses(
  LPSMESSAGECLASSARRAY pMsgClassArray,
  ULONG ulFlags,
  LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

Parameters

• pMsgClassArray
  [in] A pointer to an array that contains the names of the message classes to resolve. Message class names are always ANSI strings, never Unicode.

• 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.

• ppfrminfoarray
  [out] A pointer to a pointer to an array of form information objects. If a client application passes NULL in the pMsgClassArray 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

Client applications call the IMAPIFormContainer::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. The array of form information objects returned in the ppfrminfoarray parameter provides further access to each of the forms' properties.

Notes to Callers

To resolve a group of message classes to forms, pass 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), the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.

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, do not assume that all message classes have been successfully resolved. Instead, check the values in the returned array.

MFCMAPI Reference

For MFCMAPI sample code, see the following table.

File	Function	Comment
FormContainerDlg.cpp	CFormContainerDlg::OnResolveMultipleMessageClasses	MFCMAPI uses the IMAPIFormContainer::ResolveMultipleMessageClasses method to locate a form that is associated with a set of message classes.

See Also

Reference

IMAPIFormContainer::ResolveMessageClass

IMAPIFormContainer : IUnknown

Concepts

MFCMAPI as a Code Sample